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About This Guide 


This Novell® Group Wise® Ti roubleshooting 3 Guide provides diagrams to help you understand the 
structure and functioning of your GroupWise system. The guide is divided into the following 
sections: 


+ “Message Flow Diagrams” on page 11 


+ “Directory Structure Diagrams” on page 61 
Other sources of troubleshooting assistance include: 


+ Novell Support (http://www.novell.com/support) 
+ Novell Support Knowledgebase (http://www.novell.com/support/supportcentral) 
¢ GroupWise 7 Support Forums (http://support.novell.com/forums/2gw.html) 


+ Novell GroupWise Support Community (http://www.novell.com/support/ 
browse.do? WidgetName=BROWSE_PRODUCT&BROWSE PRODUCT.TaxoName=SG_S 
upportGoals&NodeType=leaf& NodeName=Group Wise& TaxoName=SG_SupportGoals&BR 
OWSE_PRODUCT.isProductTaxonomy=true& BROWSE _PRODUCT.Nodeld=SG_GROUP 
WISE 1 1&BROWSE_ PRODUCT.NodeType=leaf&BROWSE PRODUCT.thisPageUrl=% 
2Fproduct%2Fproducts.do&Nodeld=SG_GROUPWISE_1_ 1&id=m1&AppContext=AC_Site 
Central) 


+ GroupWise Cool Solutions (http://www.novell.com/coolsolutions/gwmag/index.html) 


Audience 


This guide is intended for network administrators who install and administer GroupWise.. 


Feedback 


We want to hear your comments and suggestions about this manual and the other documentation 
included with this product. Please use the User Comments feature at the bottom of each page of the 
online documentation, or go to www.novell.com/documentation/feedback.html and enter your 
comments there. 


Documentation Updates 


For the most recent version of GroupWise 7 Troubleshooting 3: Message Flow and Directory 
Structure, visit the GroupWise 7 Documentation Web site (http://www.novell.com/documentation/ 
gw7). 


Additional Documentation 


For additional GroupWise documentation, see the following guides at the GroupWise 7 
Documentation Web site (http://www.novell.com/documentation/gw7): 


+ Installation Guide 
+ Administration Guide 


+ Multi-System Administration Guide 


About This Guide 


+ Interoperability Guide 


+ 


Troubleshooting 1: Error Messages 


+ 


Troubleshooting 2: Solutions to Common Problems 
+ GroupWise Client User Guides 
+ GroupWise Client Frequently Asked Questions (FAQ) 


Documentation Conventions 


In Novell documentation, a greater-than symbol (>) is used to separate actions within a step and 
items in a cross-reference path. 


A trademark symbol (™, ®, etc.) denotes a Novell trademark. An asterisk denotes a third-party 
trademark. 


When a single pathname can be written with a backslash for some platforms or a forward slash for 
other platforms, the pathname is presented with a backslash. Users of platforms that require a 
forward slash, such as Linux*, should use forward slashes as required by your software. 


When a startup switch can be written with a forward slash for some platforms or a double hyphen for 
other platforms, the startup switch is presented with a forward slash. Users of platforms that require 
a double hyphen, such as Linux, should use double hyphens as required by your software. 


10 GroupWise 7 Troubleshooting 3: Message Flow and Directory Structure 


Message Flow Diagrams 


This part of Troubleshooting 3: Message Flow and Directory Structure helps you understand how 
messages travel between GroupWise” users and how administrative updates to Group Wise 


databases occur. 
+ Chapter 1, “Message Delivery in the Local Post Office,” on page 13 
+ Chapter 2, “Message Delivery to a Different Post Office,” on page 19 
+ Chapter 3, “Message Delivery to a Different Domain,” on page 27 
+ Chapter 4, “Message Delivery to and from the Internet,” on page 35 
+ Chapter 5, “Message Delivery through a Modem Connection,” on page 51 
+ Chapter 6, “Administrative Database Update,” on page 59 
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Message Delivery in the Local 
Post Office 


The GroupWise® 7 client always uses client/server access to the post office but it can interact with 
the POA for the post office in different ways. For a review, see “Using Different GroupWise Modes 
(Online, Caching, and Remote)” in “Getting Started” in the GroupWise 7 Windows Client User 
Guide. 


¢ Section 1.1, “Online Mode,” on page 13 
¢ Section 1.2, “Caching Mode,” on page 15 
+ Section 1.3, “Remote Mode,” on page 18 


1.1 Online Mode 


This message flow diagram illustrates how a GroupWise message travels from one user to another in 
the local post office when the client and POA communicate by way of TCP/IP and the users are 
accessing their Online mailboxes. 


Figure 1-1 Message Flow in Online Mode 


wpcsin 
L 0.7 
ofmsg 
L msgnnn.db 
ofuser 
L- userxxx.db 
offiles 
L fdo-7f 
wpcsout 


ads 
Lo-7 
ofs 


Table 1-1 Message Flow in Online Mode Stages 





Stage Icon Description 
11] En The user sends a message to recipients in the same post office. The 
Sender access mode setting for the post office is Client/Server Only. 
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Icon 


Description 


12) 3 The GroupWise client communicates with the POA by way of TCP/IP. 


Stage 


Sender's 
GroupWise 
Client 


13) 
POA for Local 
Post Office 


(4) 
POA for Local 
Post Office 


5] 
Recipient's 
GroupWise 
Client 


O 


Recipient 

Q 

Recipient's 
GroupWise Client 
18] 


POA for Local 
Post Office 


19] 
POA for Local 
Post Office 


D 


Sender 


P 
POA 


The POA receives the message from the GroupWise client and 
performs the following actions for the sender: 


+ Adds the message to the message database (msgnnn. db) 
assigned to the sender. 


+ Creates a pointer in the sender’s user database (userxxx. db) 
so the message appears in the sender’s mailbox as a sent item. 


+ Places attachments larger than 2 KB in one of the 
post _office\offiles\fd0-F6 subdirectories and creates 
pointers from the message to its attachments. (For database 
efficiency, messages and distribution lists larger than 2 KB are 
also handled as attachments.) 


The POA also performs the following actions for the recipient: 


+ Creates a pointer in each recipient’s user database 
(userxxx.db) to the message in the message database 
(msgnnn. db) so the new message appears in the recipient's 
mailbox. 


+ Updates the message in the message database (msgnnn. db) 
with a Delivered status for each recipient. 


The POA communicates to the GroupWise client by way of TCP/IP that 
a new message has arrived. 


The Notify component of the recipient's GroupWise client notifies the 
recipient that a new message has arrived. 


Each recipient opens the message in the GroupWise client. 


Each recipient’s GroupWise client communicates the Opened status to 
the POA by way of TCP/IP. 


The POA receives the Opened status from the GroupWise client and 
updates the message in the message database with the Opened 
status for each recipient who opens the message. 


The POA communicate the Opened status to the sender’s GroupWise 
client by way of TCP/IP. 


When the sender checks the sent items in his or her mailbox in the 
GroupWise client, the message displays a status of Delivered for each 
recipient (and possibly Opened as well if the recipient has opened the 


message). 
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1.2 Caching Mode 


This message flow diagram illustrates how a Group Wise message travels from one user to another in 
the local post office when the users are accessing their Caching mailboxes. 


Figure 1-2 Message Flow in Caching Mode 


A =. 











POA 110) 
rofdata b ' rofdata 
er i msg.db 
user.db ' user.db 
wprof.db wpesin A wprof.db 
a wpcsin L 9.7 en wpcsin 
e» Ly ofmsg Al 
L msgnnn.db 
ofuser 
userxxx.db 
offiles 
L- fdo-7f 
wpcsout 
ads 
Lo-7 
ofs 
L 0-7 
Table 1-2 Message Flow in Caching Mode Stages 
Stage Icon Description 
11] ea The user sends a message to recipients in the same post office. The 
Sender 


user is in Caching mode. 
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Stage Icon Description 


12] S The GroupWise client updates the sender's Caching mailbox 


Sender's (\novell\groupwise\gwxxxxxxx\rofdata) by performing the 
GroupWise following actions: 
Client 


+ Adds the message to the message database 
(rofdata\msg.db) in the Caching mailbox. This database is 
local equivalent of the msgnnn.db database in the post office. 


+ Creates a pointer in the sender's user database 
(rofdata\user. db) in the Caching mailbox so the message 
appears in the sender’s mailbox as a sent item. This database is 
the local equivalent of the userxxx.db database in the post 
office. 


+ Places attachments larger than 2 KB in the rofdata 
subdirectory in the Caching mailbox and creates pointers from 
the message to its attachments. (For database efficiency, 
messages and distribution lists larger than 2 KB are also handled 
as attachments.) There is no local equivalent to the of files 
subdirectory in the post office, so attachments are placed directly 
in the rofdata subdirectory in the Caching mailbox. 


+ Places a copy of the message in the rofdata\wpcsin\1 
priority subdirectory to await the next connection to the POA. 


O 3 In Caching mode, sending a message always initiates an immediate 

Sender’s connection with the POA in order to send the message. The 

GroupWise GroupWise client communicates the message to the POA and deletes 

Client the copy in the rofdata\wpcsin\1 priority subdirectory when the 
POA has processed the message. 

4] POA The POA receives the message from the GroupWise client and 

POA for Local performs the following actions for the sender to update the sender’s 

Post Office Online mailbox: 


+ Adds the message to the message database (msgnnn. db) 
assigned to the sender in the post office. 


+ Creates a pointer in the sender’s user database (user xxx. db) in 
the post office. 


+ Places attachments larger than 2 KB in one of the 
post_office\offiles\fd0-F6 subdirectories in the post 
office and creates pointers from the message to its attachments. 
(For database efficiency, messages and distribution lists larger 
than 2 KB are also handled as attachments.) 


The POA also performs the following actions for the recipients to 
update their Online mailboxes: 


+ Creates a pointer in each recipient's user database 
(userxxx.db) to the message in the message database 
(msgnnn. db) in the post office so that the new message appears 
in each recipients mailbox. 


+ Updates the message in the message database (msgnnn. db) in 
the post office with a Delivered status for the recipients. 
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Stage 


O 
POA for Local 
Post Office 


Q 
POA for Local 
Post Office 


Q 
Recipient's 
GroupWise 
Client 


[8] 
Recipient's 
GroupWise 
Client 


O 


Recipient 

D 

Recipient's 
GroupWise Client 


D 
Recipienťs 
GroupWise Client 


(12) 
POA for Local 
Post Office 


® 
Recipient's 
GroupWise Client 


D 
POA for Local 
Post Office 


Icon 


POA 


Description 


Because the recipients are also in Caching mode, they do not receive 
immediate notification that a new message has arrived in their Online 
mailboxes. Based on the Send/Retrieve All Marked Accounts Every nn 
Minutes option under Accounts > Account Options > General, each 
recipient's GroupWise client sends a request to the POA for items that 
have arrived in the recipient’s Online mailbox since the last connection 
with the POA. 


The POA responds by sending information to update each recipient’s 
Caching mailbox and communicates to the GroupWise client that a 
new message has arrived. 


Each recipients GroupWise client updates the recipient's Caching 
mailbox by performing the following actions: 


+ Adds the message to the message database 
(rofdata\msg.db) in the recipients Caching mailbox. 


+ Creates a pointer in the recipient's user database 
(rofdata\user. db) to the message in the message database 
(rofdata\msg.db) so the new message appears in the 
recipient’s Caching mailbox. 


The Notify component of each recipient's GroupWise client notifies the 
recipient that a new message has arrived. 


Each recipient opens the message in the GroupWise client. 


Each recipient’s GroupWise client generates an Opened status and 
places it in the rofdata\wpcsin\1 priority subdirectory to await the 
next connection with the POA. 


When each recipient sends a message or the time specified by the 
Send/Receive All Marked Accounts Every nn Minutes option has 
elapsed, each recipients GroupWise client connects with the POA and 
communicates the Opened status to the POA, along with any other 
data that needs to be uploaded to the recipient’s Online mailbox. 


The POA receives the Opened status from the GroupWise client and 
updates the message in the sender’s message database with the 
Opened status. 


Because the sender is in Caching mode, the sender does not 
immediately receive the Opened status. Based on the sender’s actions 
and caching schedule, the sender’s GroupWise client eventually sends 
a request to the POA for items that have arrived in the sender’s Online 
mailbox since the last synchronization of the Caching mailbox. 


The POA responds by sending information to update the sender’s 
Caching mailbox and communicates the Opened status to the sender’s 
GroupWise client. 
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Stage Icon Description 


® S The sender's GroupWise client updates the sender's Caching mailbox 


Recipient's by performing the following action: 


GroupWise Client 
+ Updates the message in the message database 


(rofdata\msg.db) with a Delivered and Opened status for 
each recipient. 


D aa When the sender checks the sent items in his or her mailbox in the 
Sender GroupWise client, the message displays a status of Delivered and 
Opened for each recipient. 


1.3 Remote Mode 


Before you can use Remote mode, you must create a Remote mailbox on your computer and have a 
connection to your master GroupWise system. See Chapter 5, “Message Delivery through a Modem 
Connection,” on page 51. 
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Message Delivery to a Different 
Post Office 


The MTA handles message transfer between post offices. 


+ Section 2.1, “TCP/IP Link Open: Transfer between Post Offices Successful,” on page 19 
+ Section 2.2, “TCP/IP Link Closed: Transfer between Post Offices Delayed,” on page 22 


The message flow diagrams in GroupWise 7 Troubleshooting 3: Message Flow and Directory 
Structure focus on TCP/IP links because they are the most common and convenient (unless you 
have a post office and a domain on the same server). For diagrams that include mapped/UNC links, 
see GroupWise 6.5 Troubleshooting 3: Message Flow and Directory Structure. For an explanation 
of link types and link protocols, see “Understanding Link Configuration” in “Domains” in the 
GroupWise 7 Administration Guide. 


2.1 TCP/IP Link Open: Transfer between Post 
Offices Successful 


This message flow diagram illustrates how a GroupWise® message travels from one user to another 
between post offices in the same domain when the TCP/IP link between the post office and the 
domain is open. 


Figure 2-1 Message Flow When the TCP/IP Link is Open 
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Table 2-1 Message Flow When the TCP/IP Link is Open Stages 


Stage Icon Description 
11] a The user sends a message to recipients in a different post office in the same 
Sender domain. 


In this diagram, the access mode setting in the local post office is Client/ 


Server Only. 
12] 3 The GroupWise client communicates the message to the POA by way of 
Sender's TCPIIP. 
GroupWise 
Client 
r 
© POA The POA receives the message from the GroupWise client and performs the 
POA for following actions for the sender: 
Sender’s 
Post Office + Adds the message to the message database (msgnnn. db) assigned to 
the sender. 

+ Creates a pointer in the sender’s user database (userxxx.db) so the 
message appears in the sender’s mailbox as a sent item. 

+ Places attachments larger than 2 KB in one of the 
post office\offiles\fd0-F6 subdirectories and creates pointers 
from the message to its attachments. (For database efficiency, 
messages and distribution lists larger than 2 KB are also handled as 
attachments.) 

+ Creates a copy of the message in the appropriate priority 0-7 
subdirectory of the MTA input queue in the sender’s post office, in case 
the TCP/IP link to the MTA is currently closed. 

y 
4] POA The POA then communicates the message to the MTA by way of TCP/IP, 
POA for and deletes the copy in the MTA input queue because the TCP/IP transfer to 
Sender's the MTA was successful. 
Post Office 
To see what happens if the TCP/IP link to the MTA is closed, see 
Section 2.2, “TCP/IP Link Closed: Transfer between Post Offices Delayed,” 
on page 22. 
wr 
5] MTA The MTA receives the message and places it into the MTA “in progress” 
MTA for (gwinprog) queue. 
Local Domain 
r 
o MTA The MTA then communicates the message to the POA in the recipient's post 
MTA for office by way of TCP/IP. When the transmission is successful, the MTA 
Local Domain deletes the message from the MTA “in progress” queue. 


If the TCP/IP link to the recipient's post office is closed, the message is 
placed in the closed post office’s holding queue in the MTA’s mslocal 
directory for later transfer. The resulting message flow is parallel to what 
occurs when a domain is closed. See Section 3.2, “TCP/IP Link Closed: 
Transfer between Domains Delayed,” on page 31 for a similar message flow 
that illustrates how messages to closed locations are handled. 
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Stage 


Q 

POA for 
Recipient's 
Post Office 


8) 
POA for Local 
Post Office 


O 
Recipient's 
GroupWise 
Client 


D 


Recipient 


D 
Recipient's 
GroupWise 
Client 


(12) 

POA for 
Recipient's 
Post Office 
® 


MTA for 
Local Domain 


D 
MTA for 
Local Domain 


(15) 

POA in 
Sender’s 
Post Office 


Icon 


POA 


Description 


When the POA receives the new message from the MTA, it places it into the 
MTA output queue in the post office (wocsout\ofs\ 0-7) on behalf of the 
MTA. Then, the POA for the recipient’s post office performs the following 
actions: 


+ Adds the message to the message database (msgnnn. db) 
corresponding to the one assigned to the sender. 


+ Creates a pointer in the recipient's user database (userxxx. db) so 
the new message appears in the recipient's mailbox and updates the 
notification information in the user database so the recipient can be 
notified of the message. 


+ Places attachments larger than 2 KB in one of the 
post _office\offiles\fd0-F6 subdirectories and creates pointers 
from the message to its attachments. (For database efficiency, 
messages and distribution lists larger than 2 KB are also handled as 
attachments.) 


+ Creates a Delivered status message in the appropriate priority 0-7 
subdirectory of the MTA input queue in the recipient's post office. It 
also communicates the Delivered status message directly to the MTA 
by way of TCP/IP. When that transmission is successful, the copy in 
the MTA input queue is deleted. 


The POA communicates to the GroupWise client by way of TCP/IP that a 
new message has arrived. 


The Notify component of the recipient's GroupWise client notifies the 
recipient that a new message has arrived. 


Each recipient opens the message in the GroupWise client. 


Each recipient's GroupWise client communicates the Opened status 
message to the POA by way of TCP/IP. 


The POA for the recipient’s post office communicates the status message to 
the MTA by way of TCP/IP. 


The MTA places the status message into the MTA “in progress” (gwinprog) 
queue. 


The MTA communicates the status message to the POA for the sender’s 
post office by way of TCP/IP. 


The POA for the sender’s post office updates the sender’s message 
database (msgnnn. db) with the Delivered status information (and possibly 
Opened as well if the recipient has opened the message). 
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Stage Icon 


Description 


D POA The POA communicates the status to the sender’s GroupWise client by way 
POA for Local of TCP/IP. 

Post Office 

17] an When the sender checks the sent items in his or her mailbox in the 

Sender GroupWise client, the message displays a status of Delivered for each 


recipient (and possibly Opened as well if the recipient has opened the 
message). 


2.2 TCP/IP Link Closed: Transfer between Post 
Offices Delayed 


This message flow diagram illustrates how a GroupWise message travels from one user to another 
between post offices in the same domain when the TCP/IP link between the post office and the 
domain is closed. 


Figure 2-2 Message Flow When the TCP/IP Link is Closed 
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Table 2-2 Message Flow When the TCP/IP Link is Closed Stages 


Stage 


Icon 


Description 


O a The user sends a message to recipients in a different post office in the same 


Sender 


2 


Sender’s 
GroupWise 
Client 


O 

POA for 
Sender's 
Post Office 


14] 

POA for 
Sender's 
Post Office 


O 
MTA for 
Local Domain 


Q 
MTA for 
Local Domain 


al 
MTA 


wr 
MTA 


domain. 


In this diagram, the access mode setting in the local post office is Client/ 
Server Only. 


The GroupWise client communicates the message to the POA by way of 
TCP/IP. 


The POA receives the message from the GroupWise client and performs the 
following actions for the sender: 


+ Adds the message to the message database (msgnnn. db) assigned 
to the sender. 


+ Creates a pointer in the sender’s user database (userxxx.db) so the 
message appears in the sender’s mailbox as a sent item. 


+ Places attachments larger than 2 KB in one of the 
post _office\offiles\fd0-F6 subdirectories and creates 
pointers from the message to its attachments. (For database efficiency, 
messages and distribution lists larger than 2 KB are also handled as 
attachments.) 


+ Creates a copy of the message in the appropriate priority 0-7 
subdirectory of the MTA input queue in the sender’s post office, in case 
the TCP/IP link to the MTA is currently closed. 


The POA then attempts to communicate the message to the MTA by way of 
TCP/IP, but the MTA does not respond. The POA leaves the copy of the 
message in the MTA input queue and periodically attempts to contact the 
MTA. When the MTA responds again, the POA communicates the message 
and deletes the copy in the MTA input queue after the TCP/IP transmission 
to the MTA is successful. 


The MTA receives the message and places it into the MTA “in progress” 
(gwinprog) queue. 


The MTA then communicates the message to the POA in the recipient’s post 
office by way of TCP/IP. When the transmission is successful, the MTA 
deletes the message from the MTA “in progress” (gwinprog) queue. 


If the TCP/IP link to the recipient's post office is closed, the message is 
placed in the closed post office’s holding queue in the MTA’s mslocal 
directory for later transfer. The resulting message flow is parallel to what 
occurs when a domain is closed. For a similar message flow that illustrates 
how messages to closed locations are handled, see Section 3.2, “TCP/IP 
Link Closed: Transfer between Domains Delayed,” on page 31. 
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Stage 


Q 

POA for 
Recipient's 
Post Office 


18] 
POA for Local 
Post Office 


O 
Recipient's 
GroupWise 
Client 


D 


Recipient 


D 
Recipient's 
GroupWise 
Client 


(12) 

POA for 
Recipient’s 
Post Office 
® 


MTA for 
Local Domain 


D 
MTA for 
Local Domain 


(15) 

POA in 
Sender’s 
Post Office 


Icon 


POA 


Ad 
MTA 


wr 
MTA 


Description 


When it receives the new message, the POA for the recipient's post office 
performs the following actions: 


+ Adds the message to the message database (msgnnn. db) 
corresponding to the one assigned to the sender. 


+ Creates a pointer in the recipient's user database (userxxx. db) so 
the new message appears in the recipient's mailbox and updates the 
notification information in the user database so the recipient can be 
notified of the message. 


+ Places attachments larger than 2 KB in one of the 
post_office\offiles\fd0-F6 subdirectories and creates 
pointers from the message to its attachments. (For database efficiency, 
messages and distribution lists larger than 2 KB are also handled as 
attachments.) 


+ Creates a Delivered status message in the appropriate priority 0-7 
subdirectory of the MTA input queue in the recipient's post office. It 
also communicates the Delivered status message directly to the MTA 
by way of TCP/IP and when that transmission is successful, the copy in 
the MTA input queue is deleted. 


The POA communicates to the GroupWise client by way of TCP/IP that a 
new message has arrived. 


The Notify component of the recipient's GroupWise client notifies the 
recipient that a new message has arrived. 


Each recipient opens the message in the GroupWise client. 


Each recipient's GroupWise client communicates the Opened status 
message to the POA by way of TCP/IP. 


The POA for the recipient's post office communicates the status message to 
the MTA by way of TCP/IP. 


The MTA places the status message into the MTA “in progress” (gwinprog) 
queue. 


The MTA communicates the status message to the POA for the sender’s 
post office by way of TCP/IP. 


The POA for the sender’s post office updates the sender’s message 
database (msgnnn. db) with the Delivered status information (and possibly 
Opened as well if the recipient has opened the message). 
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Stage Icon Description 


16) POA The POA communicates the Opened status to the sender’s GroupWise 

POA for Local client by way of TCP/IP. 

Post Office 

(17) aa When the sender checks the sent items in his or her mailbox in the 

Sender GroupWise client, the message displays a status of Delivered for each 
recipient (and possibly Opened as well if the recipient has opened the 
message). 
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Message Delivery to a Different 
Domain 


The MTA handles message transfer between domains. 


¢ Section 3.1, “TCP/IP Link Open: Transfer between Domains Successful,” on page 27 

¢ Section 3.2, “TCP/IP Link Closed: Transfer between Domains Delayed,” on page 31 
The message flow diagrams in GroupWise 7 Troubleshooting 3: Message Flow and Directory 
Structure focus on TCP/IP links because they are the most common and convenient (unless you 
have two domains on the same server). For diagrams that include mapped/UNC links, see 
GroupWise 6.5 Troubleshooting 3: Message Flow and Directory Structure. For an explanation of 


link types and link protocols, see “Understanding Link Configuration” in “Domains” in the 
GroupWise 7 Administration Guide. 


3.1 TCP/IP Link Open: Transfer between 
Domains Successful 


This message flow diagram illustrates how a GroupWise® message travels from one user to another 
when the domains are connected by a TCP/IP link and the link is open. 


Figure 3-1 Message Flow When the TCP/IP Link is Open 
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Table 3-1 Message Flow When the TCP/IP Link is Open Stages 


Stage Icon Description 
O a The user sends a message to recipients in a post office in a different domain. 
meee In this diagram, the access mode setting for the local post office is Client/Server 
Only. 
8 3 The GroupWise client communicates the message to the POA by way of TCP/ 
Sender's IP. 
GroupWise 
Client 
© POA The POA receives the message from the GroupWise client and performs the 
POA for following actions for the sender: 
Sender’s 
Post Office + Adds the message to the message database (msgnnn. db) assigned to 
the sender. 
+ Creates a pointer in the sender’s user database (userxxx.db) so the 
message appears in the sender’s mailbox as a sent item. 
+ Places attachments larger than 2 KB in one of the 
post office\offiles\fd0-F6 subdirectories and creates pointers 
from the message to its attachments. (For database efficiency, messages 
and distribution lists larger than 2 KB are also handled as attachments.) 
+ Creates a copy of the message in the appropriate priority 0-7 
subdirectory of the MTA input queue in the sender’s post office, in case 
the TCP/IP link to the MTA is currently closed. 
o POA The POA then communicates the message to the MTA for the sender’s domain 
POA for by way of TCP/IP, and deletes the copy in the MTA input queue because the 
Sender’s TCP/IP transfer to the MTA was successful. 
Post Office 
To see what would happen if the TCP/IP link to the MTA is closed, see 
Section 2.2, “TCP/IP Link Closed: Transfer between Post Offices Delayed,” on 
page 22. 
O MTA The MTA for the sender’s domain receives the message and places it into the 
MTA for MTA “in progress” (gwinprog) queue. 
Sender’s 
Domain 
o MTA The MTA for the sender’s domain then communicates the message to the MTA 
MTA for for the recipient's domain by way of TCP/IP. 
Sender’s 
Domain If the TCP/IP link to the recipient’s domain is closed, the message is placed in 
the closed domain’s holding queue in the MTA's mslocal directory for later 
transfer. See Section 3.2, “TCP/IP Link Closed: Transfer between Domains 
Delayed,” on page 31. 
Q MTA The MTA for the recipient's domain receives the message and places it into the 
MTA for MTA “in progress” (gwinprog) queue. 
Recipient's 
Domain 
O MTA The MTA for the recipient's domain then communicates the message to the 
MTA for POA in the recipient's post office by way of TCP/IP. 
Recipient's 
Domain 
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Stage 


19) 

POA for 
Recipient's 
Post Office 


D 

POA for 
Recipienťs 
Post Office 


(11) 
Recipient’s 
GroupWise 
Client 


@ 


Recipient 


® 
Recipient's 
GroupWise 
Client 


D 

POA for 
Recipient's 
Post Office 
® 

MTA for 
Recipient's 
Domain 

D 

MTA for 
Recipienťs 
Domain 

(17) 

MTA for 


Sender’s 
Domain 


Icon 


POA 


wy 
MTA 


wr 
MTA 


wy 
MTA 


Description 


When it receives the new message, the POA for the recipient's post office 
performs the following actions: 


+ Adds the message to the message database (msgnnn. db) corresponding 
to the one assigned to the sender. 


+ Creates a pointer in the recipient's user database (userxxx. db) so the 
new message appears in the recipient's mailbox and updates the 
notification information in the user database so the recipient can be 
notified of the message. 


+ Places attachments larger than 2 KB in one of the 
post_office\offiles\fd0-F6 subdirectories and creates pointers 
from the message to its attachments. (For database efficiency, messages 
and distribution lists larger than 2 KB are also handled as attachments.) 


+ Creates a Delivered status message in the appropriate priority 0-7 
subdirectory of the MTA input queue in the recipient’s post office. It also 
communicates the Delivered status message directly to the MTA by way 
of TCP/IP and when that transmission is successful, the copy in the MTA 
input queue is deleted. 


The POA for the recipient’s post office communicates to the GroupWise client 
by way of TCP/IP that a new message has arrived. 


The Notify component of the recipient’s GroupWise client notifies the recipient 
that a new message has arrived. 


Each recipient opens the message in the GroupWise client. 
Each recipient’s GroupWise client communicates the Opened status message 


to the POA by way of TCP/IP. 


The POA for the recipient’s post office communicates the status message to 
the MTA for the recipient's domain by way of TCP/IP. 


The MTA for the recipient's domain places the status message into the MTA “in 
progress” (gwinprog) queue. 


The MTA for the recipient's domain communicates the status message to the 
MTA for the sender's domain by way of TCP/IP. 


The MTA for the sender's domain places the status message into the MTA “in 
progress” (gwinprog) queue. 
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Stage Icon Description 


D MTA The MTA for the sender’s domain communicates the status message to the 
MTA for POA for the sender’s post office by way of TCP/IP. 

Sender’s 

Domain 

(19) POA The POA for the sender’s post office updates the sender’s message database 
POA for (msgnnn.db) with the Delivered status information (and possibly Opened as 
Sender’s well if the recipient has opened the message). 

Post Office 

© POA The POA for the sender’s post office communicates the status to the sender’s 
POA for GroupWise client by way of TCP/IP. 

Sender’s 

Post Office 

@ a When the sender checks the sent items in his or her mailbox in the GroupWise 
Sender client, the message displays a status of Delivered for each recipient (and 


possibly Opened as well if the recipient has opened the message). 


3.2 TCP/IP Link Closed: Transfer between 
Domains Delayed 


This message flow diagram illustrates how a GroupWise message travels from one user to another 
when the domains are connected by a TCP/IP link and the link is closed. 


Figure 3-2 Message Flow When the TCP/IP Link is Closed 
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Table 3-2 Message Flow When the TCP/IP Link is Closed Stages 


Stage 


Icon 


Description 


O a The user sends a message to recipients in a post office in a different domain. 


Sender 


8 
Sender’s 
GroupWise 
Client 


O 

POA for 
Sender's 
Post Office 


14] 

POA for 
Sender's 
Post Office 


O 

MTA for 
Sender's 
Domain 


Q 

MTA for 
Sender’s 
Domain 


Q 

MTA for 
Recipient's 
Domain 


a 
MTA 


Ad 
MTA 


MTA 


In this diagram, the access mode setting for the local post office is Client/ 
Server Only. 


The GroupWise client communicates the message to the POA by way of TCP/ 
IP. 


The POA receives the message from the GroupWise client and performs the 
following actions for the sender: 


+ Adds the message to the message database (msgnnn. db) assigned to 
the sender. 


+ Creates a pointer in the sender’s user database (userxxx.db) so the 
message appears in the sender's mailbox as a sent item. 


+ Places attachments larger than 2 KB in one of the 
post office\offiles\fd0-F6 subdirectories and creates pointers 
from the message to its attachments. (For database efficiency, 
messages and distribution lists larger than 2 KB are also handled as 
attachments.) 


+ Creates a copy of the message in the appropriate priority 0-7 
subdirectory of the MTA input queue in the sender’s post office, in case 
the TCP/IP link to the MTA is currently closed. 


The POA then communicates the message to the MTA for the sender’s 
domain by way of TCP/IP, and deletes the copy in the MTA input queue 
because the TCP/IP transfer to the MTA was successful. 


To see what would happen if the TCP/IP link to the MTA is closed, see 
Section 2.2, “TCP/IP Link Closed: Transfer between Post Offices Delayed,” on 
page 22. 


The MTA for the sender’s domain receives the message and places it into the 
MTA “in progress” (gwinprog) queue. 


The MTA for the sender’s domain then attempts to communicate the message 
to the MTA for the recipient’s domain by way of TCP/IP, but the recipient MTA 
does not respond. Therefore, the MTA stores the message in its holding 
queue for the recipient's domain in the msho1d directory. 


When the MTA in the recipient's domain responds again, the MTA for the 
sender's domain transfers the delayed message from the domain holding 
queue to the MTA in the recipient's domain by way of TCP/IP. 


The MTA for the recipient's domain receives the message and places it into 
the MTA “in progress” (gwinprog) queue. 
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Stage Icon 


O HTA 
MTA for 
Recipient's 
Domain 

(9) POA 
POA for 
Recipient's 

Post Office 


D POA 
POA for 
Recipient’s 

Post Office 


o @ 
Recipient's 
GroupWise 

Client 


@ 


Recipient 
® 


Recipient's 
GroupWise 

Client 

D POA 
POA for 
Recipient's 

Post Office 


® MTA for MTA 
Recipient's 
Domain 

D MTA 
MTA for 
Recipient's 
Domain 


Description 


The MTA for the recipient's domain then communicates the message to the 
POA in the recipient’s post office by way of TCP/IP. 


When it receives the new message, the POA for the recipient's post office 
performs the following actions: 


+ Adds the message to the message database (msgnnn. db) 
corresponding to the one assigned to the sender. 


+ Creates a pointer in the recipient’s user database (userxxx.db) so the 
new message appears in the recipient’s mailbox and updates the 
notification information in the user database so the recipient can be 
notified of the message. 


+ Places attachments larger than 2 KB in one of the 
post _office\offiles\fd0-F6 subdirectories and creates pointers 
from the message to its attachments. (For database efficiency, 
messages and distribution lists larger than 2 KB are also handled as 
attachments.) 


+ Creates a Delivered status message in the appropriate priority 0-7 
subdirectory of the MTA input queue in the recipient's post office. It also 
communicates the Delivered status message directly to the MTA by way 
of TCP/IP and when that transmission is successful, the copy the MTA 
input queue is deleted. 


The POA for the recipient's post office communicates to the GroupWise client 
by way of TCP/IP that a new message has arrived. 


The Notify component of the recipient’s GroupWise client notifies the recipient 
that a new message has arrived. 


Each recipient opens the message in the GroupWise client. 


Each recipient's GroupWise client communicates the Opened status message 
to the POA by way of TCP/IP. 


The POA for the recipient's post office communicates the status message to 
the MTA for the recipient's domain by way of TCP/IP. 


The MTA for the recipient’s domain places the status message into the “in 
progress” (gwinprog) queue. 


The MTA for the recipient's domain communicates the status message to the 
MTA for the sender's domain by way of TCP/IP. 
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Stage 


p 

MTA for 
Sender’s 
Domain 


8) 

MTA for 
Sender's 
Domain 


(19) 

POA for 
Sender’s 
Post Office 


® 

POA for 
Sender’s 
Post Office 


@ 


Sender 


Icon 


MTA 


(mi 
MTA 


Description 


The MTA for the sender’s domain places the status message into the MTA “in 
progress” (gwinprog) queue. 


The MTA for the sender’s domain communicates the status message to the 
POA for the sender’s post office by way of TCP/IP. 


The POA for the sender’s post office updates the sender’s message database 
(msgnnn.db) with the Delivered status information (and possibly Opened as 
well if the recipient has opened the message). 


The POA for the sender’s post office communicates the status to the sender’s 
GroupWise client by way of TCP/IP. 


When the sender checks the sent items in his or her mailbox in the GroupWise 
client, the message displays a status of Delivered for each recipient (and 
possibly Opened as well if the recipient has opened the message). 
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Message Delivery to and from the 
Internet 


+ Section 4.1, “TCP/IP Link: Outbound Transfer to the Internet Successful,” on page 35 


+ Section 4.2, “TCP/IP Link: Outbound Transfer to the Internet Delayed or Unsuccessful,” on 
page 38 


+ Section 4.3, “Mapped/UNC Link: Outbound Transfer to the Internet Successful,” on page 41 


+ Section 4.4, “Mapped/UNC Link: Outbound Transfer to the Internet Delayed or Unsuccessful,” 
on page 43 


+ Section 4.5, “TCP/IP Link: Inbound Transfer from the Internet Successful,” on page 47 
+ Section 4.6, “Mapped/UNC Link: Inbound Transfer from the Internet Successful,” on page 49 


4.1 TCP/IP Link: Outbound Transfer to the 
Internet Successful 


This message flow diagram shows how outbound messages travel through the GroupWise? 
directory structure to the Internet when there is a TCP/IP link between the MTA and the Internet 
Agent and when the Internet Agent can communicate successfully with the Internet host to which 
the message is addressed. 


Figure 4-1 Message Flow When the TCP/IP Link is Open 
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Table 4-1 Message Flow When the TCP/IP Link is Open Stages 


Stage Icon Description 
11] aa The user sends a message to recipients across the Internet by providing their 
Sender Internet addresses. 


In this diagram, the access mode setting for the local post office is Client/ 


Server Only. 
e a The GroupWise client communicates the message to the POA by way of TCP/ 
Sender’s IP. 
GroupWise 
Client 
© POA The POA receives the message from the GroupWise client and performs the 
POA for following actions for the sender: 
Sender’s 
Post Office + Adds the message to the message database (msgnnn. db) assigned to 
the sender. 

+ Creates a pointer in the sender’s user database (userxxx. db) so the 
message appears in the sender's mailbox as a sent item. 

+ Places attachments larger than 2 KB in one of the 
post _office\offiles\fd0-F6 subdirectories and creates pointers 
from the message to its attachments. (For database efficiency, 
messages and distribution lists larger than 2 KB are also handled as 
attachments.) 

+ Creates a copy of the message in the appropriate priority 0-7 
subdirectory of the MTA input queue in the sender's post office, in case 
the TCP/IP link to the MTA is currently closed. 

4] POA The POA then communicates the message to the MTA for the sender’s 
POA for domain by way of TCP/IP, and deletes the copy in the MTA input queue 
Sender's because the TCP/IP transfer to the MTA was successful. 
Post Office 
5] MTA The MTA for the sender’s domain receives the message and places it into the 
MTA for MTA “in progress” (gwinprog) queue. 
Sender’s 
Domain 
o NTA The MTA determines that the message must be sent out across the Internet. 
MTA for Because there is a TCP/IP link between the MTA and the Internet Agent, the 
Sender’s MTA creates a copy of the message in the appropriate priority 0-7 
Domain subdirectory of the Internet Agent hold queue 

(mslocal\mshold\ gatewayx\ 0-7), in case the TCP/IP link to the Internet 

Agent is currently closed. 
Q MTA The MTA then communicates the message to the Internet Agent for the 
MTA for sender’s domain by way of TCP/IP, and deletes the copy in the Internet Agent 
Sender’s holding queue because the TCP/IP transfer to the Internet Agent was 
Domain successful. 
O Ga The Internet Agent receives the message and places it into the MTA output 
Internet queue (wpcsout\gwid\ 0-7) on behalf of the MTA. The MTA output queue is 
Agent for the Internet Agent input queue. 
Sender’s 
Domain 
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Stage 


Icon 


Description 


Q Ga The Internet Agent scans its input queues according to the /dle Sleep Duration 


setting on the Gateway Time Settings page of the Internet Agent object in 
ConsoleOne®. The Internet Agent picks up the file in binary-encrypted format 
from the wpcsout\gwid\ 0-7 directory and converts it. 


Internet 
Agent for 
Sender’s 
Domain 


D 
Internet 
Agent for 
Sender’s 
Domain 


141] 
Internet 
Agent for 
Sender's 
Domain 


(12) 
Internet 
Agent for 
Sender’s 
Domain 


® 

MTA for 
Sender’s 
Domain 


D 

MTA for 
Sender’s 
Domain 


(15) 

POA for 
Sender’s 
Post Office 


© 

POA for 
Sender’s 
Post Office 


@ 


Sender 


Ga 


Ga 


Ga 


The Internet Agent encodes the message in MIME format with the appropriate 


encoding scheme. 


When the message file is built, the Internet Agent saves it with S as the first 
character of the filename and places the message file in the 
domain\wpgate\gwia\send directory for processing. 


While the Internet Agent is processing the message file in the send directory, it 
changes the first character of the filename to P. When processing is 
completed, the Internet Agent sends the message to the destination host 


across the Internet. 


If the Internet Agent receives a 250 OK SMTP reply code from the destination 
Internet host, it places a Transferred status message into the input queue of 
the MTA for the sender’s domain in case the TCP/IP link to the Internet Agent 


is currently closed. 


The Internet Agent then communicates the Transferred status message to the 
MTA for the sender’s domain by way of TCP/IP, and deletes the copy in the 
MTA input queue because the TCP/IP transfer to the MTA was successful. 


The MTA for the sender’s domain receives the Transferred status message 
and places it into the MTA “in progress” (gwinprog) queue for processing. 


The MTA for the sender’s domain communicates the Transferred status 
message to the POA for the sender’s post office by way of TCP/IP. 


The POA for the sender’s post office updates the sender’s message database 
(msgnnn. db) with the Transferred status information. 


The POA for the sender’s post office communicates the Transferred status to 


the sender’s GroupWise client by way of TCP/IP. 


When the sender checks the sent items in his or her mailbox in the GroupWise 
client, the message displays the Transferred status because the Internet 


Agent was able to sent it successfully. 
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4.2 TCP/IP Link: Outbound Transfer to the 
Internet Delayed or Unsuccessful 


This message flow diagram shows how outbound messages travel through the Group Wise directory 
structure to the Internet when there is a TCP/IP link between the MTA and the Internet Agent and 


when the Internet Agent cannot communicate successfully with the Internet host to which the 


message is addressed. 


Figure 4-2 Message Flow When the TCP/IP Link is Closed 
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Table 4-2 Message Flow When the TCP/IP Link is Closed Stages 


Stage 





defer —o 


: wpcsin 
`~-- L 0-7 





Icon Description 

11) The user sends a message to recipients across the Internet by providing their 

Sender Internet addresses. 
In this diagram, the access mode setting for the local post office is Client/ 
Server Only. 

12] 3 The GroupWise client communicates the message to the POA by way of TCP/ 

Sender's IP. 

GroupWise 

Client 
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Stage 


O 

POA for 
Sender's 
Post Office 


14] 

POA for 
Sender's 
Post Office 


O 

MTA for 
Sender's 
Domain 


Q 

MTA for 
Sender’s 
Domain 


Q 

MTA for 
Sender’s 
Domain 


(8 
Internet 
Agent for 
Sender’s 
Domain 


O 


Internet 
Agent for 
Sender's 
Domain 


Icon 


POA 


MTA 


Ya 
MTA 


Description 


The POA receives the message from the GroupWise client and performs the 
following actions for the sender: 


+ Adds the message to the message database (msgnnn. db) assigned to 
the sender. 


+ Creates a pointer in the sender’s user database (userxxx.db) so the 
message appears in the sender’s mailbox as a sent item. 


+ Places attachments larger than 2 KB in one of the 
post _office\offiles\fd0-F6 subdirectories and creates pointers 
from the message to its attachments. (For database efficiency, 
messages and distribution lists larger than 2 KB are also handled as 
attachments.) 


+ Creates a copy of the message in the appropriate priority 0-7 
subdirectory of the MTA input queue in the sender's post office, in case 
the TCP/IP link to the MTA is currently closed. 


The POA then communicates the message to the MTA for the sender’s 
domain by way of TCP/IP, and deletes the copy in the MTA input queue 
because the TCP/IP transfer to the MTA was successful. 


The MTA for the sender’s domain receives the message and places it into the 
MTA “in progress” (gwinprog) queue. 


The MTA determines that the message must be sent out across the Internet. 
Because there is a TCP/IP link between the MTA and the Internet Agent, the 
MTA creates a copy of the message in the appropriate priority 0-7 
subdirectory of the Internet Agent hold queue 
(mslocal\mshold\gatewayx\ 0-7), in case the TCP/IP link to the Internet 
Agent is currently closed. 


The MTA then communicates the message to the Internet Agent for the 
sender’s domain by way of TCP/IP, and deletes the copy in the Internet Agent 
holding queue because the TCP/IP transfer to the Internet Agent was 
successful. 


The Internet Agent receives the message and places it into the MTA output 
queue (wpcsout \ gwid\ 0-7) on behalf of the MTA. The MTA output queue is 
the Internet Agent input queue. 


The Internet Agent scans its input queues according to the /dle Sleep Duration 
setting on the Gateway Time Settings page of the Internet Agent object in 
ConsoleOne. The Internet Agent picks up the file in binary-encrypted format 
from the wpcsout \gwid\ 0-7 directory and converts it. 


The Internet Agent encodes the message in MIME format with the appropriate 
encoding scheme. 


When the message file is built, the Internet Agent saves it with S as the first 
character of the filename and places the message file in the 
domain\wpgate\gwia\send directory for processing. 
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Stage Icon Description 


D Ga While the Internet Agent is processing the message file in the send directory, it 


Internet changes the first character of the filename to P. When processing is 

Agent for completed, the Internet Agent sends the message to the destination host 
Sender’s across the Internet. 

Domain 

D Ga If the Internet Agent does not receive a 250 OK SMTP reply code from the 
Internet destination Internet host, the Internet Agent renames the P* . * message file 
Agent for back to S* .* and creates a file named R* . * that records the SMTP reply 
Sender's codes (error messages) in the wogate\ gwia\result directory. After the 
Domain Internet Agent completes the communication with the destination host, it 


moves the s* .* message file from the send directory to the result directory 
along with the corresponding R* . * file. 


(12) Ga The Internet Agent analyzes the files in the result directory, comparing the 
Internet SMTP reply codes in the R* . * file. 

Agent for 

Sender's If the R* . * file has a temporary transmission error (meaning it has a 400-level 
Domain SMTP reply code such as 450 Host Down), the Internet Agent moves the 


s*.* message file to the defer directory. Continue with Stage ® 


If the R* . * file has a fatal error (meaning it has a 500-level SMTP reply code 
such as 550 Host Unknown), the Internet Agent deletes the s~ . * file because 
it is undeliverable. Skip to Stage © 


® Ga Based on the /ntervals to the Retry a Deferred Message setting on the SMTP/ 
Internet MIME Settings property page of the Internet Agent object in ConsoleOne, the 
Agent for Internet Agent requeues the s * .* message file back into the send directory 
Sender's for reprocessing. 

Domain 

D Ga After an s* .* message receives 400-level SMTP reply codes until the 
Internet Maximum Number of Hours to Retry a Deferred Message setting is reached, 
Agent for or if a message receives 500-level SMTP reply codes, the Internet Agent 
Sender's deletes all related schedule files from the defer directory because the 

Domain message is undeliverable. The Internet Agent then creates an Undeliverable 


status message in the MTA input queue (wpgatelgwialWwpcesinl 0-7) in 
case the TCP/IP link to the MTA is currently closed. 


45) Ga The Internet Agent then communicates the Transferred status message to the 
Internet MTA for the sender’s domain by way of TCP/IP, and deletes the copy in the 
Agent for MTA input queue because the TCP/IP transfer to the MTA was successful. 
Sender’s 

Domain 

D MTA The MTA for the sender’s domain receives the Transferred status message 
MTA for and places it into the MTA “in progress” (gwinprog) queue for processing. 
Sender's 

Domain 

117) MTA The MTA for the sender’s domain communicates the Transferred status 
MTA for message to the POA for the sender’s post office by way of TCP/IP. 
Sender’s 

Domain 
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Stage Icon Description 


8) POA The POA for the sender’s post office updates the sender’s message database 
POA for (msgnnn. db) with the Transferred status information. 

Sender’s 

Post Office 

(19) POA The POA for the sender’s post office communicates the Transferred status to 
POA for the sender’s GroupWise client by way of TCP/IP. 

Sender’s 

Post Office 

© co When the sender checks the sent items in his or her mailbox in the GroupWise 
Sender client, the message displays the Transferred status because the Internet 


Agent was able to send it successfully. 


4.3 Mapped/UNC Link: Outbound Transfer to the 
Internet Successful 


This message flow diagram shows how outbound messages travel through the Group Wise directory 
structure to the Internet when there is a mapped/UNC link between the MTA and the Internet Agent 
and when the Internet Agent can communicate successfully with the Internet host to which the 
message is addressed. 


Figure 4-3 Message Flow When the Mapped Link is Open 


(14) MTA GWIA 


ALLI Y + 

























a mslocal 
gwinprog Destination 
L- 0-7 Host 
mshold 
wpcsin ere wpcsin 8 
»Lo7 ee L 0.7 
ofms wpcsout 
L o ie L ads 
ofuser gatewayx Lo-7 
L userxxx.db L 0-7 wpgate 
offiles wanes gwia 
L fdo-7f L 0-7 wpcsout 
wpcsout gwid 
ads L 
L 0.7 send 
ofs result 
L 0-7 defer 


wpcsin 
L 0-7 


Message Delivery to and from the Internet 


Table 4-3 Message Flow When the Mapped Link is Open Stages 


Stage Icon Description 
11] aa The user sends a message to recipients across the Internet by providing their 
Sender Internet addresses. 


In this diagram, the access mode setting for the local post office is Client/ 


Server Only. 
12] $ The GroupWise client communicates the message to the POA by way of TCP/ 
Sender's IP. 
GroupWise 
Client 
r 
© POA The POA receives the message from the GroupWise client and performs the 
POA for following actions for the sender: 
Sender’s 
Post Office + Adds the message to the message database (msgnnn. db) assigned to 
the sender. 

+ Creates a pointer in the sender’s user database (userxxx. db) so the 
message appears in the sender's mailbox as a sent item. 

+ Places attachments larger than 2 KB in one of the 
post _office\offiles\fd0-F6 subdirectories and creates pointers 
from the message to its attachments. (For database efficiency, 
messages and distribution lists larger than 2 KB are also handled as 
attachments.) 

+ Creates a copy of the message in the appropriate priority 0-7 
subdirectory of the MTA input queue in the sender's post office, in case 
the TCP/IP link to the MTA is currently closed. 

Pai 
(4) POA The POA then communicates the message to the MTA for the sender’s 
POA for domain by way of TCP/IP, and deletes the copy in the MTA input queue 
Sender's because the TCP/IP transfer to the MTA was successful. 
Post Office 

r 
5] MTA The MTA for the sender's domain receives the message and places it into the 
MTA for MTA “in progress” (gwinprog) queue. 
Sender's 
Domain 

r 
o MTA The MTA determines that the message must be sent out across the Internet. 
MTA for Because there is a mapped/UNC link between the MTA and the Internet 
Sender's Agent, the MTA places the message in its output queue in the Internet Agent's 
Domain gateway directory (domain\wpgate\gwia\wpcsout\ gwid\ 0-7). 
Q Ga The Internet Agent scans its input queues according to the /dle Sleep Duration 
Internet setting on the Gateway Time Settings page of the Internet Agent object in 
Agent for ConsoleOne. The Internet Agent picks up the file in binary-encrypted format 
Sender’s from the wpcsout \gwid\ 0-7 directory and converts it. 
Domain 


The Internet Agent encodes the message in MIME format with the appropriate 
encoding scheme. 


When the message file is built, the Internet Agent saves it with S as the first 
character of the filename and places the message file in the 
domain\wpgate\gwia\send directory for processing. 
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Stage Icon Description 


[8] = While the Internet Agent is processing the message file in the send directory, it 


Internet changes the first character of the filename to P. When processing is 

Agent for completed, the Internet Agent sends the message to the destination host 

Sender’s across the Internet. 

Domain 

9) Ga If the Internet Agent receives a 250 OK SMTP reply code from the destination 

Internet Internet host, it places a Transferred status message into the input queue of 

Agent for the MTA for the sender’s domain. 

Sender’s 

Domain 

D MTA Because of its mapped/UNC link with the Internet Agent, the MTA regularly 

MTA for scans its input queue in the Internet Agent’s gateway directory based on the 

Sender’s Scan Cycle setting on the Agent Settings page of the MTA object in 

Domain ConsoleOne. It picks up the Transferred status messages and transfers them 
to its “in progress“ (gwinprog) directory for processing. 

(11) MTA The MTA for the sender’s domain communicates the Transferred status 

MTA for messages to the POA for the sender’s post office by way of TCP/IP. 

Sender’s 

Domain 

@ POA The POA for the sender’s post office updates the sender’s message database 

POA for (msgnnn. db) with the Transferred status information. 

Sender’s 

Post Office 

® POA The POA for the sender’s post office communicates the Transferred status to 

POA for the sender’s GroupWise client by way of TCP/IP. 

Sender’s 

Post Office 

D en When the sender checks the sent items in his or her mailbox in the GroupWise 

Sender client, the message displays the Transferred status because the Internet 


Agent was able to sent it successfully. 


4.4 Mapped/UNC Link: Outbound Transfer to the 
Internet Delayed or Unsuccessful 


This message flow diagram shows how outbound messages travel through the GroupWise directory 
structure to the Internet when there is a mapped/UNC link between the MTA and the Internet Agent 
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and when the Internet Agent cannot communicate successfully with the Internet host to which the 
message is addressed. 


Figure 4-4 Message Flow When the Mapped Link is Closed 
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Table 4-4 Message Flow When the Mapped Link is Closed Stages 
Stage Icon Description 
11] The user sends a message to recipients across the Internet by providing their 
Sender Internet addresses. 


In this diagram, the access mode setting for the local post office is Client/ 


Server Only. 
12] E The GroupWise client communicates the message to the POA by way of TCP/ 
Sender's IP. 
GroupWise 
Client 
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Stage 
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Post Office 
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Post Office 
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MTA for 
Sender’s 
Domain 
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MTA for 
Sender’s 
Domain 


Internet 
Agent for 
Sender’s 
Domain 


(8) 
Internet 
Agent for 
Sender’s 
Domain 


O 


Internet 
Agent for 
Sender's 
Domain 


Icon 


POA 


Y 
MTA 


Description 


The POA receives the message from the GroupWise client and performs the 
following actions for the sender: 


+ Adds the message to the message database (msgnnn. db) assigned to 
the sender. 


+ Creates a pointer in the sender’s user database (userxxx.db) so the 
message appears in the sender’s mailbox as a sent item. 


+ Places attachments larger than 2 KB in one of the 
post _office\offiles\fd0-F6 subdirectories and creates pointers 
from the message to its attachments. (For database efficiency, 
messages and distribution lists larger than 2 KB are also handled as 
attachments.) 


+ Creates a copy of the message in the appropriate priority 0-7 
subdirectory of the MTA input queue in the sender's post office, in case 
the TCP/IP link to the MTA is currently closed. 


The POA then communicates the message to the MTA for the sender’s 
domain by way of TCP/IP, and deletes the copy in the MTA input queue 
because the TCP/IP transfer to the MTA was successful. 


The MTA for the sender’s domain receives the message and places it into the 
MTA “in progress” (gwinprog) queue. 


The MTA determines that the message must be sent out across the Internet. 
Because there is a mapped/UNC link between the MTA and the Internet 
Agent, the MTA places the message in its output queue in the Internet Agent's 
gateway directory (domain\wpgate\gwia\wpcsout\ gwid\ 0-7). 


The Internet Agent scans its input queues according to the /dle Sleep Duration 
setting on the Gateway Time Settings page of the Internet Agent object in 
ConsoleOne. The Internet Agent picks up the file in binary-encrypted format 
from the wpcsout \gwid\ 0-7 directory and converts it. 


The Internet Agent encodes the message in MIME format with the appropriate 
encoding scheme. 


When the message file is built, the Internet Agent saves it with S as the first 
character of the filename and places the message file in the 
domain\wpgate\gwia\send directory for processing. 


While the Internet Agent is processing the message file in the send directory, it 
changes the first character of the filename to P. When processing is 
completed, the Internet Agent sends the message to the destination host 
across the Internet. 


If the Internet Agent does not receive a 250 OK SMTP reply code from the 
destination Internet host, the Internet Agent renames the P* . * message file 
back to S* .* and creates a file named R* . * that records the SMTP reply 
codes (error messages) in the wpgate\ gwia\result directory. After the 
Internet Agent completes the communication with the destination host, it 
moves the s* . * message file from the send directory to the result directory 
along with the corresponding R* . * file. 
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Stage Icon Description 


D = The Internet Agent analyzes the files in the result directory, comparing the 


Internet SMTP reply codes in the R* . * file. 
Agent for 
Sender's If the R* . * file has a temporary transmission error (meaning it has a 400-level 
Domain SMTP reply code such as 450 Host Down), the Internet Agent moves the 
s* .* message file to the defer directory. Continue with Stage (11) 
If the R* . * file has a fatal error (meaning it has a 500-level SMTP reply code 
such as 550 Host Unknown), the Internet Agent deletes the s~ . * file because 
it is undeliverable. Skip to Stage @ 
D Ga Based on the /ntervals to the Retry a Deferred Message setting on the SMTP/ 
Internet MIME Settings property page of the Internet Agent object in ConsoleOne, the 
Agent for Internet Agent requeues the s *.* message file back into the send directory 
Sender’s for reprocessing. 
Domain 
(12) Ga After an s* .* message receives 400-level SMTP reply codes until the 
Internet Maximum Number of Hours to Retry a Deferred Message setting is reached, 
Agent for or if a message receives 500-level SMTP reply codes, the Internet Agent 
Sender's deletes all related schedule files from the defer directory because the 
Domain message is undeliverable. The Internet Agent then creates an Undeliverable 
status message for the MTA to pick up and return to the sender. 
® MTA Because of its mapped/UNC link with the Internet Agent, the MTA scans its 
MTA for input queue in the Internet Agent’s gateway directory based on the Scan Cycle 
Sender's setting on the Agent Settings page of the MTA object in ConsoleOne. The 
Domain MTA picks up the Undeliverable status messages and transfers them to its “in 
progress* (gwinprog) directory for processing. 
D MTA The MTA for the sender’s domain communicates the Transferred status 
MTA for messages to the POA for the sender’s post office by way of TCP/IP. 
Sender’s 
Domain 
® POA The POA for the sender’s post office updates the sender’s message database 
POA for (msgnnn. db) with the Transferred status information. 
Sender’s 
Post Office 
D POA The POA for the sender’s post office communicates the Transferred status to 
POA for the sender’s GroupWise client by way of TCP/IP. 
Sender’s 
Post Office 
D A When the sender checks the sent items in his or her mailbox in the GroupWise 
Sender client, the message displays the Transferred status because the Internet 


Agent was able to send it successfully. 
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4.5 TCP/IP Link: Inbound Transfer from the 
Internet Successful 


This message flow diagram illustrates how inbound message flow from the Internet through the 
GroupWise directory structure to the Group Wise recipient. The link between the Internet Agent and 
the MTA for the recipient’s domain is a TCP/IP link. 


Figure 4-5 Message Flow in From the Internet 


Destination 
Host 






GWIA 


“nae 


mslocal POA 


& 
: | 
> 








ES i gwinprog 
N L07 b 
Š mshold 
domainms wpesin 
gwia A p oe LO7 ase" 
wpcsout Y postb cea 
wena F recieve ' L 0-7 ; msgnnn.db 
wpcsin J ofuser 
Pio >» L 0-7 --" C L- userxxx.db 
offiles 
domains L fdo-7f 
L 0-7 
wpcsout 
ads 
L 0.7 
ofs 
Lo-7 


Table 4-5 Message Flow in From the Internet Stages 


Stage 


Actor 


Action 


11] Ga An Internet user sends a message to a GroupWise user. The Internet Agent 


Internet 
Agent for 
Recipient's 
Domain 


2) 


Internet 
Agent for 
Recipient's 
Domain 


Ga 


receives the message from the external Internet host and places the 
message file in the wogate\ gwia\receive directory. 


The Internet Agent polls the receive directory according to the /dle Sleep 
Duration setting on the Gateway Time Settings page of the Internet Agent 
object in ConsoleOne. It picks up the message file, converts it to 
GroupWise format, and places a copy in the wpogate\ gwia\wpcsin\ 0-7 
directory, where 0-7 is one of the priority subdirectories from 0-7. The 
Internet Agent puts messages only in the 4 directory, used for normal 
priority messages. 
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Stage Actor Action 


O = The Internet Agent then communicates the message to the MTA for the 


Internet recipients domain by way of TCP/IP. When the transmission is successful, 
Agent for it deletes the copy in the in the wpgate\ gwia\wpcsin\ 0-7 directory. 
Recipient's 

Domain 

4] MTA The MTA for the recipient's domain receives the message and places it into 
MTA for the MTA “in progress” (gwinprog) queue. 

Recipient's 

Domain 

O MTA The MTA determines which post office in the domain the recipient is located 
MTA for in, then moves the message to that post office’s hold queue 

Recipient's (mslocal\mshold\postx\ 0-7). 

Domain 

o MTA The MTA for the recipient's domain then communicates the message to the 
MTA for POA in the recipient’s post office by way of TCP/IP. 

Recipient's 

Domain 

Q POA When it receives the new message, the POA for the recipient's post office 
POA for performs the following actions: 

Recipient's 

Post Office + Adds the message to the message database (msgnnn. db file) 


corresponding to the one assigned to the sender. 


+ Creates a pointer in the recipient's user database (user xxx. db file), 
so the message appears in the recipients Mailbox and updates the 
notification information in the user database so the recipient can be 
notified of the message. 


+ Places attachments larger than 2 KB in one of the 
post _office\offiles\fd0-F6 subdirectories and creates 
pointers from the message to its attachments. (For database 
efficiency, messages and recipient lists larger than 2 KB are also 
handled as attachments.) 


18) > The Notify component of the recipient's GroupWise client notifies the 
Recipient's recipient that a new message has arrived. 

GroupWise 

Client 

O co Each recipient opens the message in the GroupWise client. 
Recipient 
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4.6 Mapped/UNC Link: Inbound Transfer from 
the Internet Successful 


This message flow diagram illustrates how inbound message flow from the Internet through the 
GroupWise directory structure to the GroupWise recipient. The link between the Internet Agent and 
the MTA for the recipient’s domain is a mapped/UNC link. 


Figure 4-6 Message Flow in From the Internet 
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Table 4-6 Message Flow in From the Internet Stages 





Stage Actor Action 

11] An Internet user sends a message to a GroupWise user. The Internet Agent 

Internet receives the message from the external Internet host and places the 

Agent for message file in the wogate\ gwia\receive directory. 

Recipient's 

Domain 

8 a The Internet Agent polls the receive directory according to the /dle Sleep 

Internet Duration setting on the Gateway Time Settings page of the Internet Agent 

Agent for object in ConsoleOne. It picks up the message file, converts it to 

Recipient's GroupWise format, and places it in the wogate\ gwia\wpcsin\ 0-7 

Domain directory, where 0-7 is one of the priority subdirectories from 0-7. The 
Internet Agent puts messages only in the 4 directory, used for normal 
priority messages. 

© MTA The MTA polls the domain\wpgate\gwia\wpcsin\fd0-7F directory 

MTA for based on the Scan Cycle setting on the Agent Settings page of the MTA 

Recipienťs object in ConsoleOne. It picks up the message file and moves it to its “in 

Domain progress” (gwinprog) queue. 
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Stage Actor Action 


4 MTA The MTA determines which post office in the domain the recipient is located 
MTA for in, then moves the message to that post office’s hold queue 

Recipient's (mslocal\mshold\postx\0-7). 

Domain 

5] MTA The MTA for the recipient's domain then communicates the message to the 
MTA for POA in the recipient’s post office by way of TCP/IP. 

Recipient's 

Domain 

o POA When it receives the new message, the POA for the recipient's post office 
POA for performs the following actions: 

Recipient's 

Post Office + Adds the message to the message database (msgnnn. db file) 


corresponding to the one assigned to the sender. 


+ Creates a pointer in the recipient's user database (userxxx. db file), 
so the message appears in the recipient's Mailbox and updates the 
notification information in the user database so the recipient can be 
notified of the message. 


+ Places attachments larger than 2 KB in one of the 
post _office\offiles\fd0-F6 subdirectories and creates 
pointers from the message to its attachments. (For database 
efficiency, messages and recipient lists larger than 2 KB are also 
handled as attachments.) 


Q a The Notify component of the recipient's GroupWise client notifies the 
Recipient's recipient that a new message has arrived. 

GroupWise 

Client 

O Gn Each recipient opens the message in the GroupWise client. 
Recipient 
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Message Delivery through a 


Modem Connection 


GroupWise® client users can still access information in their mailboxes even when not connected to 


the network by running the GroupWise client in Remote mode. 


+ Section 5.1, “““Hit the Road” Process in Online Mode,” on page 51 


+ Section 5.2, “Modem Link through the Async Gateway in Remote Mode,” on page 53 


5.1 


“Hit the Road” Process in Online Mode 


This message flow diagram illustrates how a user who will be away from the network prepares to 
access GroupWise from a remote location by downloading mailbox contents. 


Figure 5-1 Message Flow for Hit the Road 
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Table 5-1 Message Flow for Hit the Road Stages 


Stage Icon Description 


11) ds The GroupWise user runs Hit the Road in Online mode in order to request 


Remote 
User 


items from the master mailbox to be downloaded to the Remote mailbox in 
preparation for disconnecting from the master GroupWise system. For 


example, the user could be preparing a laptop computer for use away from the 


network. 
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Stage Icon Description 


8 F The GroupWise client prompts the user for the location to create the Remote 


GroupWise mailbox and the types of items to download, then it transfers the request to the 
Client in POA. 

Online 

Mode 

© POA The POA receives the request from the GroupWise client and performs the 
POA for following actions: 

Remote 

User’s + Gathers all folders from the GroupWise user’s master mailbox 

Post Office (msgnnn.db and userxxx.db) so that it has somewhere to put the 


items requested by the user. 
+ Gathers the requested items from the GroupWise user's master mailbox. 


+ Gathers any attachments for requested items from the 
post _office\offiles\fd0-F6 subdirectories in the GroupWise 
user's post office. 


+ Gathers any other types of information requested by the GroupWise user, 
such as rules, address books, documents, and junk mail lists. 


Pai 

POA e compiles the information into a response file and transfers the 
o The POA piles the inf tion int p fil d transfers th 
POA for response to the GroupWise client. 
Remote 
User's 
Post Office 
8 3 The GroupWise client receives the response and performs the following 
GroupWise actions for the GroupWise user: 
Client in 
Online + Updates the GroupWise Remote message database (msg. db) with any 
Mode items requested from the user's master mailbox. 


+ Creates pointers in the GroupWise Remote user database (user. db) so 
the messages gathered from the master mailbox appear in the user's 
GroupWise mailbox when running in Remote mode. 


+ Places any requested attachments larger than 2 KB in the rofdata 
directory and creates pointers from the message to its attachments. (For 
database efficiency, messages and distribution lists larger than 2 KB are 
also handled as attachments.) 


+ Updates the Remote mailbox with any other types of information 
requested by the GroupWise user. 


The user's GroupWise Remote mailbox now contains current copies of 
requested items from the user's master mailbox. 


o A The GroupWise client restarts in Remote mode and accesses the new Remote 
Remote mailbox. The GroupWise user can now review current GroupWise mail in 
User Remote mode after the connection to the master GroupWise system is no 


longer available. 
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5.2 Modem Link through the Async Gateway in 
Remote Mode 


This message flow diagram illustrates how a GroupWise user in Remote mode can access the master 
Group Wise system through the GroupWise Async Gateway. 


Figure 5-2 Message Flow Through a Modem 
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Table 5-2 Message Flow Through a Modem Stages 
Stage Icon Description 
11] a The GroupWise user, who is working in Remote mode, sends a message to 
Remote another GroupWise user or creates a request for items from the master 
User mailbox. The remote user’s computer is not currently connected to the 


network or the user’s master GroupWise system. 
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Stage Icon Description 


12] 3 When the remote GroupWise user sends a message to another GroupWise 


GroupWise user, the GroupWise client performs the following actions in the user's 
Client in Remote mailbox: 

Remote 

Mode + Adds the message to the message database (msg. db) on the user's 


remote computer. 


+ Creates a pointer in the user database (user. db) so the message 
appears as a sent item in the Remote mailbox on the user's remote 
computer. 


+ Places attachments larger than 2 KB in the rofdata directory and 
creates pointers from the message to its attachments on the user's 
remote computer. (For database efficiency, messages and distribution 
lists larger than 2 KB are also handled as attachments.) 


+ Creates a copy of the message in the wpocsin\1 subdirectory of the 
GroupWise client's remote input queue on the user's remote computer. 


When the remote GroupWise user sends a request for items from the 
master mailbox to be downloaded to the Remote mailbox, the GroupWise 
client places the request in the wocsin\1 subdirectory of the GroupWise 
client's remote input queue on the user's remote computer. 


O 3 When the remote GroupWise user initiates the modem connection, the 
GroupWise GroupWise client polls its input queue (wpcsin\1) and compresses the 
Client in outgoing messages and/or requests into a file. If the compressed file totals 
Remote over 50 KB, additional compressed files are created. 

Mode 


The GroupWise client moves the compressed message/request files into its 
output queue (wpgwsena) directory. 


O: E The GroupWise client dials in to the gateway, logs in, then transmits the 
GroupWise compressed message/request files across the modem connection to the 
Client with GroupWise Async Gateway in the GroupWise system where the user's 
Modem master mailbox is located. 

Connection 

6 + The GroupWise Async Gateway receives the message/request files and 
Async places them into it input queue 

Gateway (wpgate\async\asyxxx\gwin\connection_id\cmp) for processing. 
o + The Async Gateway decompresses the message/request files and moves 
Async them into the subdirectory for the remote user's connection with the master 
Gateway GroupWise system. 

Q + WIth a TCP/IP link, the Async Gateway transfers the decompressed files to 
Async the MTA for the remote user's domain in the master GroupWise system. 
Gateway 


With a UNC/mapped link, the Async Gateway places the message/request 
files into the MTA's input queue (wpgate\async\wpcsin\1), where the 
MTA picks up the files. 


O MTA The MTA for the remote user’s domain receives the message/request files 
MTA for and places them into the MTA “in progress” (gwinprog) queue. 

Remote 

User’s 

Domain 
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Stage 


O 

MTA for 
Remote 
User's 
Domain 


D 

POA for 
Remote 
User’s 
Post Office 


D 

POA for 
Remote 
User’s 
Post Office 


(12) 

MTA in 
Remote 
User’s 
Domain 


Icon 


MTA 


mal 
MTA 


Description 


The MTA for the remote user’s domain then communicates the message/ 
request files to the POA for the post office where the remote user’s master 
mailbox is located. 





NOTE: This message flow diagram illustrates only the simplest case where 
the recipient is in the same post office as the remote user’s master mailbox. 
If the remote user sends a message to a user in any other post office, the 
MTA routes the message to the appropriate destination. 





When the POA receives a message from the remote user, the POA 
performs the following actions to update the remote user’s master mailbox: 


+ Adds the message to the remote user’s message database 
(msgnnn. db) in the Online mailbox. 


+ Creates a pointer in the recipient’s user database (user xxx. db) in the 
Online mailbox so that the new message appears in the recipient's 
mailbox and updates the notification information in the user database 
so the recipient can be notified of the message. 


+ Places attachments larger than 2 KB in one of the 
post _office\offiles\fd0-F6 subdirectories in the remote user's 
post office and creates pointers from the message to its attachments. 
(For database efficiency, messages and distribution lists larger than 2 
KB are also handled as attachments.) 


+ Creates a Delivered status message in the priority 1 subdirectory of the 
remote user’s MTA input queue (wpcsin) in the post office. 


When the POA receives a request for items from the remote user’s master 
mailbox, the POA performs the following actions: 


+ Gathers the requested items from the remote user's master mailbox 
(msgnnn. db). 


+ Gathers any attachments for requested items from the 
post_office\offiles\fd0-F6 subdirectory in the remote user's 
post office. 


+ Compiles the information into a response file and places it in the 
priority 1 subdirectory of the MTA input queue for return to the remote 
user. 


The POA for the remote user’s post office communicates the Delivered 
status for messages and the response file for requests to the MTA for the 
remote user’s domain. When the transfer is successful, the copies in the 
MTA input queue are deleted. 


The MTA for the remote user’s domain places the status/response files into 
the MTA “in progress” (gwinprog) queue. 
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Stage 


® 

MTA in 
Remote 
User’s 
Domain 


® 


Async 
Gateway 


45) 
Async 
Gateway 


© 

Async 
Gateway 
with Modem 
Connection 


7] 


GroupWise 
Client in 
Remote 
Mode 


D 
GroupWise 
Client in 
Remote 
Mode 


Icon 


MTA 


F 


Description 


With a TCP/IP link, the MTA for the remote user’s domain communicates the 
status/response files to the Async Gateway in the remote user’s domain. 


With a UNC/mapped link, the MTA for the remote user’s domain places the 
status/response files into the Async Gateway’s input queue 
(wogate\async\asyxxx\wpcsout\1), where the Async Gateway picks 
up the files. 


When the MTA in the GroupWise Remote user’s domain detects the 
response for the GroupWise Remote user, the MTA picks it up from its post 
office input queue and transfers it to its output queue in the Async Gateway 
directory under wpgate in the GroupWise Remote user’s domain. The MTA 
output queue in the Async Gateway directory is the input queue for the 
Async Gateway. 


The Async Gateway places the status/response files into the MTA output 
queue (wpgate\async\wpcsout\asyxxx\connection id\1) of the 
Async Gateway directory. 


If the modem connection to the remote user is still active, the Async 
Gateway compresses the status/response files and moves them to the cmp 
directory. 


If the modem connection is no longer available, the status/response files 
wait in the connection_id\1 subdirectory until a new connection is 
established by the remote user. 


The Async Gateway transmits the status/response files through the modem 
connection to the input queue (wpgwrecv) for the GroupWise client on the 
user’s remote computer. 


The GroupWise client on the remote computer decompresses the status/ 
response files and places them in its input queue (wpocsout\ofs\1) on the 
user's remote computer. 


Taking the items from its input queue, the GroupWise client performs the 
following actions to update the Remote mailbox on the user's remote 
computer: 


+ Updates the message database (msg. db) with any items requested 
from the remote user's master mailbox. 


+ Creates pointers in the user database (user . db) so the messages 
gathered from the master mailbox appear in the Remote mailbox. 


+ Places any requested attachments larger than 2 KB in the rofdata 
directory and creates pointers from the message to its attachments. 
(For database efficiency, messages and distribution lists larger than 2 
KB are also handled as attachments.) 


+ Updates the remote Address Book (wprof . db) to synchronize it with 
the Address Book in the remote user's master GroupWise system. 


The user's Remote mailbox now contains current copies of requested items 
from the remote user's master mailbox, plus any messages received in the 
user's master mailbox from other GroupWise users. 
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Stage Icon Description 


ús) a The GroupWise user can now review current GroupWise mail when the 


Remote modem connection to the master GroupWise system is no longer available. 
User 
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Administrative Database Update 


ConsoleOne® and the agents handle database updates throughout the Group Wise® system. 


This message flow diagram illustrates how an administrative message, such as a database update 
request, passes from ConsoleOne to the agents so that databases are updated throughout the 
Group Wise system. 


Figure 6-1 Administrative Message Flow through TCP/IP 
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Table 6-1 Administrative Message Flow through TCP/IP Stages 


Stage Actor Action 

11] a The administrator uses the GroupWise Administrator snap-in in ConsoleOne 
GroupWise to add, modify, or delete a GroupWise object in a single-domain, single-post 
Administrator office GroupWise system. 


An object could be a GroupWise user, resource, distribution list, post office, 
secondary domain, and so on. 
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Stage Actor Action 


12] U c 


onsoleOne performs the following actions: 


ConsoleOne 
+ Updates the domain database (wpdomain. db) to reflect the addition, 
modification, or deletion performed in ConsoleOne. 
+ Creates an administrative message in the priority 2 subdirectory of the 
domain’s MTA input queue (wpcsin) to replicate the update. 
wr 
© MTA The MTA for the domain transfers the administrative message to the MTA “in 
MTA for progress” (gwinprog) queue. From there, the MTA communicates the 
Domain administrative message to the POA in the post office by way of TCP/IP. The 
administrative message notifies the POA that a GroupWise object has been 
added, modified, or deleted. 
Historical Note: In earlier versions of GroupWise, this function of the POA was 
handled by a separate agent, the Administration Agent (ADA). The ADA no 
longer exists in GroupWise. 
7 
o POA The POA creates a copy of the administrative message in the priority 2 
POA for subdirectory of the administrative input queue (wpcsout\ ads) in the post 
Post Office office. After the update is made successfully, the copy is deleted. 
wr 
15] POA The POA updates the post office database (wphost . db) to reflect the 
POA for addition, modification, or deletion performed in ConsoleOne and deletes the 
Post Office administrative message from its administrative input queue. 


60 GroupWise 7 Troubleshooting 3: Message Flow and Directory Structure 


Directory Structure Diagrams 


This part of Troubleshooting 3: Message Flow and Directory Structure helps you understand the 
structure of GroupWise® message transfer/storage directories (such as domains and post offices) 
and software installation directories. 

+ Chapter 7, “Message Transfer/Storage Directories,” on page 63 

+ Chapter 8, “Agent Installation Directories,” on page 103 

+ Chapter 9, “Software Distribution Directory,” on page 147 

+ Chapter 10, “GroupWise Client Installation Directories,” on page 163 
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Message Transfer/Storage 


Directories 


Message transfer and storage directories are the locations through which messages pass as they 
travel from user to user through your Group Wise® system. 


¢ Section 7.1, “Domain Directory,” on page 63 


¢ Section 7.2, “Post Office Directory,” on page 70 


+ Section 7.3, “MTA Local Queue Directory,” on page 82 


+ Section 7.4, “Internet Agent Queue Directory,” on page 85 
+ Section 7.5, “WebAccess Agent Queue Directory,” on page 92 


+ Section 7.6, “Caching Mailbox Directory,” on page 94 


+ Section 7.7, “Remote Mailbox Directory,” on page 98 


7.1 Domain Directory 


= domain 
= mslocal 


H wpcsin 


w o 
E 


E wpcsout 
Ml aas 
ml o 
E 


Domain directory 
MTA local working directory 


MTA input queue directory 

Live interactive requests 

Other interactive requests 

High priority messages 

High priority status responses 
Normal priority messages 
Normal priority status responses 
Low priority messages 

Low priority status responses 


Supporting program directory 
GroupWise gateway directory 


MTA output queue directory 


MTA admin thread input queue directory 


Restart requests 


Directory synchronization requests 


Database updates 

Reserved; not currently used 
Reserved; not currently used 
Reserved; not currently used 
Reserved; not currently used 
Reserved; not currently used 
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W 


css MTA input queue directory for administrative messages 
= 0 MTA restart requests 
= ni Statistics requests 
= 2 Other non-priority administrative requests 
= 3 Reserved; not currently used 
z 4 Reserved; not currently used 
= 5 Reserved; not currently used 
w 6 Reserved; not currently used 
O > Reserved; not currently used 
Tal problem Directory for undeliverable messages 
L] mtaname Domain name identifier 
Ll wpdomain.db Domain database 
J wpdomain.dc Data dictionary for 4.x domain databases 
J wphost.dc Data dictionary for 4.x post office databases 
_] gwdom.dc Data dictionary for 5.x, 6.x, and 7.x domain databases 
E gwpo.dc Data dictionary for 5.x, 6.x, and 7.x post office databases 
viewcopy.log Log file recording view file updates for post offices 


7.1.1 domain directory 


Within the GroupWise system, a domain is hierarchically the highest level object. It organizes post 
offices into a logical grouping for addressing and routing purposes. Each user in the domain has an 
address that consists of the user's GroupWise user ID, the user’s post office name, and the domain 

name (user.post office. domain). The explicit name is not displayed in the Address Book, 
but is stored in the domain database (wpdomain . db). 


7.1.2 wpcsin directory 


The wpcsin subdirectory in the domain is the MTA input queue in each domain. It contains eight 
priority subdirectories to handle different types of message traffic. 


+ Incoming user messages are queued by priority for routing to recipients’ post offices in the 
local domain. 


+ Incoming status messages are queued by priority for routing to senders’ post offices in the local 
domain. 


+ Outgoing administrative messages are queued for replication to other domains. 


+ Ina routing domain, messages pass through this directory on their way to the next domain. 
When a new message arrives, the MTA routes it to the appropriate destination. 


For TCP/IP links, the MTA is notified immediately when a message arrives for processing. For 
mapped and UNC links, the MTA scans its input queue for messages to process. You can control the 
rate at which the MTA scans its input queues. See “Adjusting MTA Polling of Input Queues in the 
Domain, Post Offices, and Gateways” in “Optimizing the MTA” in the GroupWise 7 Administration 
Guide. 


Historical Note: WP Office*, the predecessor of GroupWise, was originally designed by 
WordPerfect Corporation* (WPCorp*). The Message Transfer Agent (MTA) was originally named 
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the Connection Server (CS). Hence, the directory name wpcsin for the MTA input queue. Some 
naming conventions were originally preserved for backward compatibility. 


0 directory 


The priority O subdirectory of the MTA input queue (wpcsin) in the domain is for service requests 
that demand an immediate response from the MTA. For example: 


* ConsoleOne® places restart requests and queue reconfiguration requests here for the MTA and 
gateways. 
+ MTAs for other domains route Busy Search requests through here when users in other domains 


check schedules of users in the local domain. 


You can increase throughput for the priority 0 subdirectory. See “Adjusting the Number of MTA 
Scanner Threads for the Domain and Post Offices” in “Optimizing the MTA” in the GroupWise 7 
Administration Guide. 


1 directory 


The priority 1 subdirectory of the MTA input queue (wpcsin) in the domain is for service requests 
of the next highest priority. For example: 
+ ConsoleOne places directory synchronization requests here for the MTA admin thread. 


+ ConsoleOne places statistics requests here for the MTA to relay to the message logging module 
for processing. 


+ MTAs for other domains route remote GroupWise client requests through here when remote 
Group Wise users do not connect to the post office where their master mailboxes are located. 


You can increase throughput for the priority 1 subdirectory. See “Adjusting the Number of MTA 
Scanner Threads for the Domain and Post Offices” in “Optimizing the MTA” in the GroupWise 7 
Administration Guide. 


2 directory 


The priority 2 subdirectory of the MTA input queue (wpcsin) in the domain is for high priority 
messages. For example: 


+ MTAs for other domains place incoming high priority user messages here. The local MTA then 
routes the messages to recipients’ post offices. 


+ MTAs for other domains place incoming administrative messages here to replicate database 
updates in the local domain. 


+ The MTA admin thread places outgoing administrative messages here to replicate database 
updates to other domains. 


You can increase throughput for the priority 2 and 3 subdirectories. See “Adjusting the Number of 
MTA Scanner Threads for the Domain and Post Offices” in “Optimizing the MTA” in the 
GroupWise 7 Administration Guide. 


3 directory 


The priority 3 subdirectory of the MTA input queue (wpcsin) in the domain is for high priority 
status messages routed back to senders in local post offices. 
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For example, MTAs for other domains place status responses to high priority user messages here. 
The local MTA then routes the status messages to senders’ post offices, so senders’ mailboxes can 
be updated with current message status. 


You can increase throughput for the priority 2 and 3 subdirectories. See “Adjusting the Number of 
MTA Scanner Threads for the Domain and Post Offices” in “Optimizing the MTA” in the 
GroupWise 7 Administration Guide. 


4 directory 


The priority 4 subdirectory of the MTA input queue (wocsin) in the domain is for normal priority 
user messages routed to recipients in local post offices. 


For example, MTAs for other domains place normal priority user messages here. The local MTA 
then routes the messages to recipients’ post offices. Most messages in your GroupWise system pass 
through the priority 4 subdirectory. 


You can increase throughput for the priority 4 subdirectory. See “Adjusting the Number of MTA 
Scanner Threads for the Domain and Post Offices” in “Optimizing the MTA” in the GroupWise 7 
Administration Guide. 


5 directory 


The priority 5 subdirectory of the MTA input queue (wpcsin) in the domain is for normal priority 
status messages routed back to senders in local post offices. 


For example, MTAs for other domains place status responses to normal priority user messages here. 
The local MTA then routes the status messages to senders’ post offices, so senders’ mailboxes can 
be updated with current message status. 


6 directory 


The priority 6 subdirectory of the MTA input queue (wpcsin) in the domain is for low priority user 
messages routed to recipients in local post offices. 


For example, MTAs for other domains place low priority user messages here. The local MTA then 
routes the messages to recipients’ post offices. 


7 directory 


The priority 7 subdirectory of the MTA input queue (wpcsin) in the domain is for low priority 
status messages routed back to senders in local post offices. 


For example, MTAs for other domains place status responses to low priority user messages here. 
The local MTA then routes the status messages to senders’ post offices, so senders’ mailboxes can 
be updated with current message status. 


7.1.3 wptools directory 


The wptools subdirectory in the domain contains programs that support Group Wise 
administration. 
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Historical Note: WP Office, the predecessor of Group Wise, was originally designed by WordPerfect 
Corporation (WPCorp). Hence, the wp in wotools. Some naming conventions were originally 
preserved for backward compatibility. 


7.1.4 wpgate directory 


The wpgate subdirectory in the domain contains a subdirectory for each GroupWise gateway you 
have installed in your GroupWise system. For a list of gateways, see the GroupWise Gateways 
Documentation Web site (http://www.novell.com/documentation/gwateways). GroupWise 5.5 
gateways can be used with GroupWise 6.x and 7.x. 


7.1.5 wpcsout directory 


The wpcsout subdirectory in the domain is the MTA output queue in each domain. It contains 
subdirectories that function as input queues for the processes to which the MTA delivers messages. 


Historical Note: WP Office, the predecessor of Group Wise, was originally designed by WordPerfect 
Corporation (WPCorp). The Message Transfer Agent (MTA) was originally named the Connection 
Server (CS). Hence, the directory name wpcsout for the MTA output queue. Some naming 
conventions were originally preserved for backward compatibility. 


ads directory 


The ads subdirectory of the MTA output queue (wocsout) in the domain is the input queue for the 
MTA admin thread in each domain. It contains priority subdirectories where incoming 
administrative messages are queued for processing. When a new administrative message arrives, the 
MTA admin thread performs the requested action. 


Historical Note: The MTA admin thread was previously part of a separate agent, the Administration 
Agent (ADA), which was originally named the Administration Server (ADS). Hence, the directory 
name ads. Some naming conventions were originally preserved for backward compatibility. 


O directory 


The priority 0 subdirectory of the MTA admin thread input queue (wpcsout \ads) in the domain 
is for service requests that demand an immediate response from the MTA admin thread. 


For example, when you create or delete a post office in ConsoleOne, a restart request is placed here. 
The domain MTA admin thread processes the request and then restarts. 


1 directory 


The priority 1 subdirectory of the MTA admin thread input queue (wpcsout \ads) in the domain 
is for service requests of the next highest priority. 


2 directory 


The priority 2 subdirectory of the MTA admin thread input queue (wpcsout \ads) in the domain 
is for high priority administrative messages. For example: 


+ The MTA places administrative messages from other domains here. The administrative 
messages might instruct the MTA admin thread to add, modify, or delete users, post offices, or 
other objects in the domain. The MTA admin thread then processes the messages and makes 
the specified updates. 
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+ When you use the Synchronize utility in ConsoleOne, a synchronization request is placed here. 
The MTA admin thread then resends the specified administrative messages to produce the 
required database updates. 


css directory 


The css subdirectory of the MTA output queue (wecsout) in the domain is processed by a 
specialized MTA thread that responds to requests regarding its own configuration. It contains the 
eight standard priority subdirectories. 


Historical Note: In an earlier version of GroupWise, the Message Transfer Agent (MTA) was called 
the Connection Server (CS) and this specialized subprocess was called the Connection Server Server 
(css). Some naming conventions were originally preserved for backward compatibility. 


O directory 


The priority 0 subdirectory of the CSS input queue (wpcsout\css) in the domain is for service 
requests that demand an immediate response from the MTA. 


For example, when you restart the MTA at the MTA agent console or in ConsoleOne, a restart 
request is placed here. The MTA processes the request and restarts. 


1 directory 


The priority 1 subdirectory of the CSS input queue (wpcsout\css) in the domain is for service 
requests of the next highest priority. 


For example, each time the statistics are updated on the MTA agent console, a statistics request is 
placed here. The MTA then gathers the statistics and displays them on the MTA agent console. 


2 directory 

The priority 2 subdirectory of the css input queue (wpcsout\css) in the domain is for non- 
priority requests. 

problem directory 


The problem subdirectory of the MTA output queue (wocsout) in the domain is where the MTA 
places message files that cannot be delivered because they are damaged in some way. Message files 
in the problem directory must be handled by the GroupWise administrator. See “Message Is 
Dropped in the problem Directory in the Domain” in GroupWise 7 Troubleshooting 2: Solutions to 
Common Problems. 


7.1.6 mtaname file 
The mtaname file in the domain provides the domain name associated with the domain directory 


structure. This can help you locate the domain information for the directory structure in 
ConsoleOne. It can also help you check links between MTAs. 


7.1.7 wpdomain.db file 


The wpdomain. db file in the domain is the domain database. It contains all administrative 
information for the domain. 
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In the primary domain, the wodomain. db file contains all administrative information for your 
entire GroupWise system (all its domains, post offices, users, and so on). Because the 

wpdomain. db file in the primary domain is so crucial, you should back it up regularly and keep it 
secure. (You can re-create your entire GroupWise system from the primary domain wodomain.db 
file; however, if the primary domain wodomain. db file becomes unusable, you can no longer 
make administrative updates to your GroupWise system.) 


In a secondary domain, the wodomain. db file contains administrative information about that 
secondary domain only. 


In GroupWise 7.x, 6.x, and 5.x domains, the data dictionary for the wodomain. db file is the 
gwdom. dc file. In GroupWise 4.x domains, the data dictionary is the wodomain.dc file. Asa 
result, wodomain. db files have different structures (schemas) depending on whether they were 
created for 7.x/6.x/5.x or 4.x domains. 


Historical Note: WP Office, the predecessor of Group Wise, was originally designed by WordPerfect 
Corporation (WPCorp). Hence, the wp in wpdomain . db. Some naming conventions were 
originally preserved for backward compatibility. 


7.1.8 wpdomain.dc file 


The wodomain.dc file in the domain is the data dictionary for rebuilding GroupWise 4.x domain 
databases (wodomain. db files) in secondary domains. 


If the wodomain. de file is missing from the primary domain, you cannot rebuild GroupWise 4.x 
secondary domains. The original wodomain. dc file is located in the domain subdirectory of the 
software distribution directory or on the GroupWise Administrator CD. 


Historical Note: WP Office, the predecessor of GroupWise, was originally designed by WordPerfect 
Corporation (WPCorp). Hence, the wp in wodomain.dc. Some naming conventions were 
originally preserved for backward compatibility. 


7.1.9 wphost.dc file 


The wphost . de file in the domain is the data dictionary for rebuilding Group Wise 4.x post office 
databases (wphost . db files). 


If the wehost . de file is missing from a domain, you cannot rebuild GroupWise 4.x post offices in 
that domain. The original wphost . de file is located in the domain directory of the software 
distribution directory or on the GroupWise Administrator CD. 


Historical Note: WP Office, the predecessor of GroupWise, was originally designed by WordPerfect 
Corporation (WPCorp). Post offices were originally called hosts. Hence, the name wphost .dc. 
Some naming conventions were originally preserved for backward compatibility. 


7.1.10 gwdom.dc file 


The gwdom. de file in the domain is the data dictionary for creating and rebuilding GroupWise 7.x, 
6.x, and 5.x domain databases (wpdomain. db files) in secondary domains. 


If the gwdom. de file is missing from the primary domain, you cannot create or rebuild GroupWise 
7.x/6.x/5.x secondary domains. The original gwdom. dc file is located in the domain directory of 
the software distribution directory or on the GroupWise distribution media. 
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7.1.11 gwpo.dc file 


The gwpo. dc file in the domain is the data dictionary for creating and rebuilding GroupWise 7.x, 
6.x, and 5.x post office databases (wphost . db files). 


If the gwpo. de file is missing from a domain, you cannot create or rebuild Group Wise 7.x/6/x/5.x 
post offices in that domain. The original gwpo. dc file is located in the domain directory of the 
software distribution directory or on the GroupWise distribution media. 


7.1.12 viewcopy.log file 


The viewcopy. log file in the domain is created by the GroupWise Installation program if you 
update the Windows client software and the Installation program is unable to copy the view files to 
any post offices in the domain. You can manually update the view files later, as described in 
“Refreshing the Client View Files in the Post Office” in “Post Offices” in the GroupWise 7 
Administration Guide. 


7.2 Post Office Directory 


E post office Post office directory 
H wcs in MTA input queue direct 
= 0 Live interactive requests 
= 1 Other interactive requests 
= 2 High priority messages 
= 3 High priority status responses 
= 4 Normal priority messages 
w 5 Normal priority status responses 
y 6 Low priority messages 
Be > Low priority status responses 
3 gwdms Document Management Services directory 
úl dmsh. db Shared Document Management Services database 
EM 15100 treff Library directories 
y dmxxnn01-ff.db Document databases 
y index QuickFinder™ index for library 
y archive Archive directory for library 
Ml docs Large document directory for library 
Hl £a00-££ Subdirectories for documents 
El ofmsg Message database directory 
O msgnnn. db As many as 255 message databases 
— ngwd£r.db Deferred message database 
= guardbak Backup guardian database 
3 ofuser User database directory 
LÌ userxxx. db User databases (one per user) 
— puxxxxx. db Databases for shared folders 
H index QuickFinder index for messages 
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O worof50.db 


0=3 
defer 


E problem 


J wphost.db 

LJ gwpo.dc 
ngwguard.db 
ngwguard.dc 


ngwguard.fbk 


ngwguard.rfl 
ngwcheck.db 


Attachment store directory 
Subdirectories for attachments 


GroupWise client view files 


GroupWise working directory 
Remote direct connection directory 


GroupWise temporary files 
MTA output queue directory 


POA input queue directory 

Live interactive requests 

Other interactive requests 

High priority messages 

High priority status responses 
Normal priority messages 

Normal priority status responses 
Low priority messages 

Low priority status responses 
Directory to temporarily store deferred messages 
POA log files 

Downloadable system Address Book 


POA admin thread input queue directory 
Restart requests 

Directory synchronization requests 
Database updates 

Reserved; not currently used 

Reserved; not currently used 

Reserved; not currently used 

Reserved; not currently used 

Reserved; not currently used 


GWCheck working directory 
GWCheck priority subdirectories 


GWCheck subdirectory for deferred database maintenance 
requests 


Directory for undeliverable messages 


Post office database 

Data dictionary for GroupWise 7.x/6.x/5.x post office databases 
Guardian database 

Data dictionary for databases 

Guardian database backup 

Guardian database roll forward log 

GWCheck control database 


7.2.1 post_office directory 


Conceptually, a post office contains mailboxes for a set of network users. The users on the post 
office send and receive messages through their mailboxes. 
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Physically, a post office is a directory structure on a network file server. The directory structure 
contains subdirectories and databases that store messages and the information used to distribute the 
messages. 


7.2.2 wpcsin directory 


The wpcsin subdirectory in the post office is the MTA input queue in each post office. It contains 
eight priority subdirectories to handle different types of message traffic. 
+ Outgoing user messages are queued by priority for routing to recipients in other post offices. 
+ Outgoing status messages are queued by priority for routing back to senders’ post offices. 


¢ Outgoing Busy Search requests are queued for routing to other post offices so users’ schedules 
can be checked. 


+ Remote GroupWise client requests are queued for routing to remote GroupWise users’ master 
mailboxes. 


When a new message arrives, the MTA routes it to the appropriate destination. 


For mapped and UNC links, the MTA scans its input queue for messages to process. You can 
control the rate at which the MTA scans its input queues. See “Adjusting MTA Polling of Input 
Queues in the Domain, Post Offices, and Gateways” in “Optimizing the MTA” in the GroupWise 7 
Administration Guide. 


For TCP/IP links, the POA passes messages to the MTA via TCP/IP. A copy is kept in the MTA 
input queue until the POA has successfully transferred the message. 


Historical Note: WP Office, the predecessor of Group Wise, was originally designed by WordPerfect 
Corporation (WPCorp). The Message Transfer Agent (MTA) was originally named the Connection 
Server (CS). Hence, the directory name wpcsin for the MTA input queue. Some naming 
conventions were originally preserved for backward compatibility. 


0 directory 


The priority 0 subdirectory of the MTA input queue (wpcsin) in the post office is for service 
requests that demand an immediate response from the MTA. 


For example, the GroupWise client places Busy Search requests here. The MTA then routes the 
requests to the appropriate post offices, so users’ schedules can be checked. 


You can increase throughput for the priority 0 subdirectory. See “Adjusting the Number of MTA 
Scanner Threads for the Domain and Post Offices” in “Optimizing the MTA” in the GroupWise 7 
Administration Guide. 


1 directory 


The priority 1 subdirectory of the MTA input queue (wpcsin) in the post office is for service 
requests of the next highest priority. For example: 


+ Remote with a direct connection places requests here for routing to remote Group Wise users” 
master mailboxes. 


+ The POA places outgoing status messages to remote GroupWise users here for routing to the 
Async Gateway. 
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You can increase throughput for the priority 1 subdirectory. See “Adjusting the Number of MTA 
Scanner Threads for the Domain and Post Offices” in “Optimizing the MTA” in the GroupWise 7 
Administration Guide. 


2 directory 


The priority 2 subdirectory of the MTA input queue (wpcsin) in the post office is for high priority 
user messages routed to recipients in other post offices, domains, or systems. 


For example, the GroupWise client places high priority user messages here. The MTA then routes 
the messages to the appropriate destinations. 


You can increase throughput for the priority 2 and 3 subdirectories. See “Adjusting the Number of 
MTA Scanner Threads for the Domain and Post Offices” in “Optimizing the MTA” in the 
GroupWise 7 Administration Guide. 


3 directory 


The priority 3 subdirectory of the MTA input queue (wpcsin) in the post office is for high priority 
status messages routed back to senders in other post offices, domains, or systems. 


For example, the GroupWise client and local POA place status responses to high priority user 
messages here. The MTA then routes the status messages to the appropriate post offices, so senders’ 
mailboxes can be updated with current message status. 


You can increase throughput for the priority 2 and 3 subdirectories. See “Adjusting the Number of 
MTA Scanner Threads for the Domain and Post Offices” in “Optimizing the MTA” in the 
GroupWise 7 Administration Guide. 


4 directory 


The priority 4 subdirectory of the MTA input queue (wpcsin) in the post office is for normal 
priority user messages routed to recipients in other post offices, domains, or systems. 


For example, the Group Wise client places normal priority user messages here. The MTA then routes 
the messages to the appropriate destinations. Most messages in your Group Wise system pass 
through the priority 4 subdirectory. 


You can increase throughput for the priority 4 subdirectory. See “Adjusting the Number of MTA 
Scanner Threads for the Domain and Post Offices” in “Optimizing the MTA” in the GroupWise 7 
Administration Guide. 


5 directory 


The priority 5 subdirectory of the MTA input queue (wpcsin) in the post office is for normal 
priority status messages routed back to senders in other post offices, domains, or systems. 


For example, the Group Wise client and local POA place status responses to normal priority user 
messages here. The MTA then routes the status messages to the appropriate post offices, so senders’ 
mailboxes can be updated with current message status. 


6 directory 


The priority 6 subdirectory of the MTA input queue (wpcsin) in the post office is for low priority 
user messages routed to recipients in other post offices, domains, or systems. 
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For example, the Group Wise client places low priority user messages here. The MTA then routes 
the messages to the appropriate destinations. 


7 directory 


The priority 7 subdirectory of the MTA input queue (wpcsin) in the post office is for low priority 
status messages routed back to senders in other post offices, domains, or systems. 


For example, the GroupWise client and local POA place status responses to low priority user 
messages here. The MTA then routes the status messages to the appropriate post offices, so senders’ 
mailboxes can be updated with current message status. 


7.2.3 gwdms directory 


The gwdms subdirectory in the post office is the Document Management Services (DMS) directory 
in each post office. It contains the document libraries associated with the post office. 


dmsh.db file 


The dmsh . db file in the document management subdirectory (gwdms) in the post office is a 
database shared by all libraries in the post office. It contains a list of all available libraries and 
lookup tables for each library. 


1ib0001-ff directories 


The 1ib0001-ff subdirectories in the gwdms subdirectory in the post office contain the libraries 
for the post office, with one library per directory. You can create a maximum of 256 libraries in a 
post office. 


dmxxnn01-ff.db files 


The dmxxnn01-ff. db files in the library subdirectories (1 ib0001-ff) in the post office are 
databases for library and document information. 


The nn in the filenames represents the partition number, which is generated by a hashing algorithm 
to guarantee uniqueness. 


The 0/-ffin the filenames represents the library number, matching the number on the library 
directory in which the database is found. 


dmsdnn01-ff.db file 
The dmsdnn01-ff.db file in each library holds system data for the library, such as library 
configuration information. 


dmddnan01-ff.db file 
The dmddnn01-ff. db file in each library holds document data for the library. Document data is 
the document property information for documents in the library. 


dmdlnn01-ff-db file 
The dmd1nn01-£f. db file in each library holds document logging data for the library. 
Document logging data records all activities performed on documents in the library. 
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index directory 


The index subdirectories in the library subdirectories (1ib0001-ff) in the post office contain 
the QuickFinder index for the documents contained in the library. 


archive directory 


The archive subdirectories in the library subdirectories (1 ib0001-ff) in the post office contain 
an array of subdirectories for holding archived documents. The subdirectories are numbered 
sequentially. When the first archive subdirectory reaches its maximum allowable size, archived 
documents are stored in the next sequential directory, and so on. 


docs directory 


The docs subdirectories in the library subdirectories (1ib0001-ff) in the post office contain an 
array of subdirectories for storing documents. 


fd0-ff directories 

The £d0-£f subdirectories in the docs subdirectory in the post office store documents that are 
equal to or greater than 2 KB in size. The 0-ff variable represents hexadecimal number 0 through ff, 
so the subdirectories are named fd0 through fdff. The document databases (dmxxnn01-ff.db 
files) contain pointers to documents stored in the subdirectories of the docs directory. 


7.2.4 ofmsg directory 


The ofmsg subdirectory in the post office contains as many as 255 databases where messages are 
stored. It serves as centralized storage for all users in the post office. A message must be stored only 
once to be delivered to any number of users in the same post office. 


Historical Note: An earlier version of GroupWise, designed by WordPerfect Corporation (WPCorp), 
was named WP Office. Hence, the of in ofmsg. Some naming conventions were originally 
preserved for backward compatibility. 


msgnnn.db file 


The msgnnn. db files in the ofmsg subdirectory in the post office are the message databases 
where users’ messages smaller than 2 KB are stored. To increase database efficiency, messages, 
attachments, and recipient lists equal to or greater than 2 KB are stored outside the msgnn. db files 
in an array of subdirectories in the of files directory. After the 2 KB limit is reached, only 
pointers are stored in the message databases. 


The nnn variable in the database names is a three-digit number from 0 to 254. A hashing algorithm 
takes each user’s GroupWise file ID (FID) to derive which database the user’s outgoing mail is 
assigned to. The contents of the messages databases are encrypted so the text of message can only be 
read through GroupWise. 


Multiple users are assigned to the same message database. You can use GWCheck to determine 
which database a specific user has been assigned to. See “GroupWise Check” in “Standalone 
Database Maintenance Programs” in the GroupWise 7 Administration Guide. 


ngwdfr.db file 


The ngwdfr. db file in the ofmsg subdirectory in the post office holds deferred messages that 
users have specified for delivery at a later ttme. When users delay delivery on messages, the 
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messages are transferred to the receiving post office and held in the ngwdfr. db file until the delay 
expires. 


Historical Note: Earlier versions of GroupWise handled deferred messages through the ofpend 
directory in the post office. 
guardbak directory 


The guardbak subdirectory in the ofmsg subdirectory in the post office holds a backup copy of 
the ngwguard. fbk file. 


7.2.5 ofuser directory 


The ofuser subdirectory in the post office contains a separate database (mailbox) for each 
Group Wise user. 


Historical Note: An earlier version of GroupWise, designed by WordPerfect Corporation (WPCorp), 
was named WP Office. Hence, the of in ofuser. Some naming conventions were originally 
preserved for backward compatibility. 


userxxx.db file 


The user xxx. db files in the ofuser subdirectory in the post office are user databases where the 
contents of users’ mailboxes are stored, as displayed in the GroupWise client In addition, each user 
database contains: 

+ Some personal GroupWise client program settings 

+ Personal appointments 

+ Personal groups 

+ Personal notes 

+ Rules 
Personal client settings that remain the same regardless of what workstation a user logs in to are 


stored in the user database. Personal client settings that are customized for a particular workstation 
are stored in the Windows* registry. 


The xxx variable in the database names is each user’s GroupWise file ID (FID). 


puxxxxx.db file 


The puxxxxx. db files in the ofuser subdirectory in the post office are databases for replicated 
items such as shared folders. These databases prevent conflicts between user names of shared items 
from users in other post offices and user names in the local post office. 


index directory 


The index subdirectory in the ofuser subdirectory in the post office contains the QuickFinder 
index for users’ messages stored in the post office. 
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7.2.6 offiles directory 


The of files subdirectory in the post office contains subdirectories for messages, attachments, 
and recipient lists that are equal to or greater than 2 KB in size. These larger messages, attachments, 
and recipient lists are stored outside the actual message databases in the ofmsg directory to increase 
database efficiency. 


Historical Note: An earlier version of GroupWise, designed by WordPerfect Corporation (WPCorp), 
was named WP Office. Hence, the of in of files. Some naming conventions were originally 
preserved for backward compatibility. 


fd0-f6 directories 


The £d0-f6 subdirectories in the of files subdirectory in the post office store messages, 
attachments, and recipient lists that are equal to or greater than 2 KB in size. The nn variable 
represents hexadecimal number 0 through f6, so the subdirectories are named £d0 through fdf6é. 
The message databases (ms gnnn. db files) contain pointers to messages, attachments, and recipient 
lists stored in the subdirectories of offiles. 


7.2.7 ofviews directory 


The ofviews subdirectory in the post office contains subdirectories for GroupWise client 
platforms. Within the platform-specific subdirectories (for example, win) are view (* . vew) files 
that create the various views displayed in the Group Wise client. 


The gwviewxx. ini and ofviewxx.ini files configure the standard views on the menus where 
users select views. The gwviewxx. ini file configures GroupWise 7.x, 6.x, and 5.5 standard 
views. The ofviewxx.ini file configures standard views from earlier versions of GroupWise. 


Historical Note: An earlier version of GroupWise, designed by WordPerfect Corporation (WPCorp), 
was named WP Office. Hence, the of in ofviews. Some naming conventions were originally 
preserved for backward compatibility. 


7.2.8 ofwork directory 


The ofwork subdirectory in the post office is a working directory for requests from the GroupWise 
client in Remote mode. 


Historical Note: An earlier version of GroupWise, designed by WordPerfect Corporation (WPCorp), 
was named WP Office. Hence, the of in ofwork. Some naming conventions were originally 
preserved for backward compatibility. 


7.2.9 ofdirect directory 


The ofdirect subdirectory in the working directory (of work) in the post office is used by the 
GroupWise client in Remote mode for direct connections when the network is available. 


Historical Note: An earlier version of Group Wise, designed by WordPerfect Corporation (WPCorp), 
was named WP Office. Hence, the of in ofdirect. Some naming conventions were originally 
preserved for backward compatibility. 
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7.2.10 oftemp directory 


The oftemp subdirectory in the post office holds various temporary files such as the MIME files 
created during access by IMAP e-mail clients. 


7.2.11 wpcsout directory 


The wpcsout subdirectory in the post office is the MTA output queue in each post office. It 
contains subdirectories which function as input queues for the other agents to which the MTA 
delivers messages. 


Historical Note: WP Office, the predecessor of Group Wise, was originally designed by WordPerfect 
Corporation (WPCorp). The Message Transfer Agent (MTA) was originally named the Connection 
Server (CS). Hence, the directory name wpcsout for the MTA output queue. Some naming 
conventions were originally preserved for backward compatibility. 


ofs directory 


The ofs subdirectory of the mta output queue (wpcsout) in the post office is the POA input queue 
in each post office. It contains eight priority subdirectories to handle different types of message 
traffic. 


+ Incoming user messages are queued by priority for delivery to recipients’ mailboxes in the 
local post office. 


+ Incoming status messages are queued by priority for delivery to senders’ mailboxes in the local 
post office. 


+ Incoming Busy Search requests are queued for the POA to check users’ schedules in the local 
post office. 


The POA scans these priority subdirectories regularly. When a new message arrives, the POA 
processes the messages and performs the required actions. 


O directory 


The priority 0 subdirectory of the POA input queue (wocsout\ofs) in the post office is for 
service requests that demand an immediate response from the POA. 


For example, the MTA places Busy Search requests here so the POA can check recipients’ 
schedules and quickly return the schedule information to the sender. 


1 directory 


The priority 1 subdirectory of the POA input queue (wocsout\ofs) in the post office is for 
service requests of the next highest priority. 


For example, the MTA places requests from remote GroupWise users for items in their master 
mailboxes here. The POA then processes the messages and returns the requested items. 


2 directory 


The priority 2 subdirectory of the POA input queue (wpcsout\ofs) in the post office is for high 
priority user messages being delivered to recipients in the local post office. 
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For example, the MTA places high priority user messages here. The POA then updates the message 
databases and recipients’ mailboxes. 


3 directory 


The priority 3 subdirectory of the POA input queue (wpcsout\ofs) in the post office is for high 
priority status messages coming back to senders in the local post office. 


For example, the MTA places status responses to high priority user messages here. The POA then 
updates the message databases and senders’ mailboxes with current message status. 


4 directory 


The priority 4 subdirectory of the POA input queue (wpocsout\ofs) in the post office is for 
normal priority user messages being delivered to recipients in the local post office. 


For example, the MTA places normal priority user messages here. The POA then updates the 
message databases and recipients’ mailboxes. Most messages in your GroupWise system pass 
through the priority 4 subdirectory. 


5 directory 


The priority 5 subdirectory of the POA input queue (wocsout\ofs) in the post office is for 
normal priority status messages coming back to senders in the local post office. 


For example, the MTA places status responses to normal priority user messages here. The POA then 
updates the message databases and senders’ mailboxes with current message status. 


6 directory 


The priority 6 subdirectory of the POA input queue (wpocsout\ofs) in the post office is for low 
priority user messages being delivered to recipients in the local post office. 


For example, the MTA places low priority messages here. The POA then updates the message 
databases and recipients’ mailboxes. 


7 directory 


The priority 7 subdirectory of the POA input queue (wpocsout\ofs) in the post office is for low 
priority status messages coming back to senders in the local post office. 


For example, the MTA places status responses to low priority user messages here. The POA then 
updates the message databases and senders’ mailboxes with current message status. 


defer directory 


The defer subdirectory of the POA input queue (wocsout\ofs) in the post office is used to 
temporarily store deferred messages when the ngwdfr . db database is locked. This might occur if 
backup software has locked the ngwd fr . db database. After the ngwdfr.db database is available 
again, deferred messages are written to the ngwdfr. db database as usual. 


mmddpoa.nnn files 


The mmddpoa.nnn files are POA log files. The POA creates log files to inform you of its 
processing and any problems it encounters. By default, these log files are created in the 
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wpcsout\ofs directory. You can change the location if needed. See “Using POA Log Files” in 
“Post Office Agent” in the GroupWise 7 Administration Guide guide. 


The first two digits of the filename represent the month, the next two digits represent the day of the 
month, and the next three characters indicate what program created the log. The three-digit 
extension is a sequence number for multiple log files created on the same day. For example, 
0518poa.002 is the second POA log file created on May 18. 


wprof50.db file 


The wprof£50. db file in the wocsout\ofs directory is the downloadable system Address Book 
for Remote client users. By default, it is automatically re-created once a day to keep it up to date. 
See “Performing Nightly User Upkeep” in “Post Office Agent” in the GroupWise 7 Administration 
Guide guide. 


ads directory 


The ads subdirectory of the MTA output queue (wecsout) in the post office 1s the input queue for 
the POA admin thread in each post office. It contains priority subdirectories where administrative 
messages are queued for processing. 


Historical Note: The POA admin thread was previously part of a separate agent, the Administration 
Agent (ADA), which was originally named the Administration Server (ADS). Hence, the directory 
name ads. Some naming conventions were originally preserved for backward compatibility. 


O directory 


The priority 0 subdirectory of the POA admin thread input queue (wocsout\ads) in the post 
office is for service requests that demand an immediate response from the POA admin thread. 


1 directory 


The priority 1 subdirectory of the POA admin thread input queue (wpcsout \ads) in the post 
office is for service requests of the next highest priority. 


For example, a directory synchronization request that could not be performed when the POA admin 
thread received it in its domain input queue would be placed here in the post office for later 
processing. 


2 directory 


The priority 2 subdirectory of the POA admin thread input queue (wpcsout \ads) in the post 
office is for high priority administrative messages. 


For example, a database update request that could not be performed when the POA admin thread 
received it in its domain input queue would be placed here in the post office for later processing. 


chk directory 


The chk subdirectory of the MTA output queue (wocsout) in the post office is the working 
directory where the multithreaded GWCheck process keeps temporary files during database 
maintenance and where it tracks the activities of its various threads. The defer subdirectory is used 
when the ngwcheck. db database is locked, for example, by a backup program. 
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problem directory 


The problem subdirectory of the MTA output queue (wpcsout) in the post office is a holding 
area for damaged message files. Problem files are marked with an extension indicating which 
GroupWise agent placed each file in the problem directory. 


You should check this directory periodically for problem files, resolve the problem, then place the 
files back into the appropriate queue for continued processing. For assistance, see “Message Is 
Dropped in the problem Directory in the Post Office” in “Strategies for Message Delivery 
Problems” in the GroupWise 7 Troubleshooting 2: Solutions to Common Problems. 


7.2.12 wphost.db file 


The wphost . db file in the post office is the post office database. It contains all administrative 
information for the post office. It also contains the Address Book for the post office. 


In GroupWise 7.x, 6.x, and 5.x post offices, the data dictionary for the wohost . db file is the 
gwpo .dc file. In GroupWise 4.x post offices, the data dictionary is the wohost.dc file. Asa 
result, wphost . db files have different structures (schemas) depending on whether they were 
created for GroupWise 7.x/6.x/5.x or 4.x post offices. 


Historical Note: WP Office, the predecessor of Group Wise, was originally designed by WordPerfect 
Corporation (WPCorp). Post offices were originally called hosts. Hence, the name wphost . db. 
Some naming conventions were originally preserved for backward compatibility. 


7.2.13 gwpo.dc file 


The gwpo. dc file in the post office is the data dictionary for creating and rebuilding GroupWise 
7.x, 6.x, and 5.x post office databases (wphost . db files). 


If the gwpo . dc file is missing from a post office and its domain, you cannot create or rebuild 
Group Wise 7.x/6.x/5.x post offices in that domain. The original gwpo. dc file is located in the 
domain directory of the software distribution directory or on the GroupWise Administrator CD. 


7.2.14 ngwguard.db file 


The ngwguard. db file in the post office is the guardian database. See “Information Stored in the 
Post Office” in “Post Office Agent” in the GroupWise 7 Administration Guide. 


7.2.15 ngwguard.dc file 


The ngwguard. dc file in the post office is the data dictionary for building the following databases 
in the post office: 

+ ngwguard. db (guardian database) 

+ dmxxnn01-ff.db (document management databases) 

+ msgnnn.db (message databases) 

+ userxxx.db (user databases) 


+ puxxxxx.db (databases for replicated items like shared folders) 
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7.2.16 ngwguard.fbk file 


The ngwguard. fbk file in the post office is a “fall back” copy of the ngwguard. db file. If the 
ngwguard. db file becomes damaged, the ngwguard. fbk file, along with the ngsguard. rfl 
file, can be used to rebuild a valid, current ngwguard. db file. The ngwguard. fbk file is so 
important that an additional copy of it is kept in the ofmsg\guardbak subdirectory in case the 
copy in the post office directory is inadvertently deleted. See “Guardian Databases” in “Databases” 
in the GroupWise 7 Administration Guide. 


7.2.17 ngwguard.rfl file 


The ngwguard. rf1 file in the post office is a roll-forward transaction log of every database 
transaction that has taken place since the last copy of the ngwguard. fbk file was created. See 
“Guardian Databases” in “Databases” in the GroupWise 7 Administration Guide. 


7.2.18 ngwcheck.db 
The ngwcheck. db file in the post office is the database that controls GWCheck’s multithreaded 


processing. It contains job and task records that are used to synchronize and summarize GWCheck 
requests as they progress. 
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7.3.1 mslocal directory 


The mslocal directory is the MTA local working directory. The /work startup switch of the MTA 
specifies the location of the mslocal directory. It must be located on the hard disk of the server 
where the MTA runs so it is always accessible. Adequate disk space must be available to hold 
messages going to destinations that are temporarily closed. 


Typical locations for the mslocal directory include: 


* sys:\systemona NetWare® server 


+ c:\ ona Windows server 


To move the mslocal directory, stop the MTA, the copy the mslocal directory, along with all of 
its subdirectories, to the new location. Then restart the MTA and specify the new location using the 
/work startup switch. 


Historical Note: In earlier versions of GroupWise, the Message Transfer Agent (MTA) was called 
the Message Server (MS). Hence, the ms inmslocal. Some naming conventions were originally 
preserved for backward compatibility. 


mmddxxx.nnn files 


The mmddxxx. nnn file are MTA log files. The MTA creates log files to inform you of its 
processing and any problems it encounters. By default, these log files are created in the ms Local 
directory. You can change the location if needed. See “Using MTA Log Files” in “Message Transfer 
Agent” in the GroupWise 7 Administration Guide. 


The first two digits of the filename represent the month; the next two digits represent the day of the 
month; the next three characters indicate what program created the log. The three-digit extension is 
a sequence number for multiple log files created on the same day. For example, 0518mta.002 is 
the second MTA log file created on May 18. 


Historical Note: In earlier versions of GroupWise, the Message Transfer Agent (MTA) was called 
the Message Server (MS). Hence, the ms indicator representing the MTA. Some naming 
conventions were originally preserved for backward compatibility. 


7.3.2 msglog directory 


The msglog subdirectory contains message logging files. It is created when you turn on message 
logging. The MTA receiver threads log messages as they arrive so the MTA worker threads can 
process messages without having to scan the MTA input queues to look for work. 


The resources used for message logging are configurable. See “Optimizing the Routing Queue” in 
“Optimizing the MTA” in the GroupWise 7 Administration Guide. 


More detailed message logging by the MTA is also available, but is turned off by default. See 
“Enabling MTA Message Logging” in “Configuring the MTA” in the GroupWise 7 Administration 
Guide. 


mmddmsg.nnn files 


The mmddmsg. nnn files in the message logging subdirectory (nsglog) in the MTA local 
directory are used by the MTA to track messages in its “in progress” queue. 
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The first two digits of the filename represent the month; the next two digits represent the day of the 
month. The three-digit extension is a sequence number for multiple files created on the same day. 
For example, 0518msg.002 is the second message logging file created on May 18. 


7.3.3 gwinprog directory 


The gwinprog subdirectory is the MTA “in progress” queue. It contains eight priority 
subdirectories parallel to those found in wpcsin. All messages for recipients in the domain pass 
through gwinprog, no matter whether they arrived by way of TCP/IP or by way of message files 
deposited into the MTA input queue by a POA or another MTA. 


The resources used to process the “in progress” queue are configurable. See “Optimizing the 
Routing Queue” in “Optimizing the MTA” in the GroupWise 7 Administration Guide. 


7.3.4 mshold directory 


The mshold subdirectory is a holding queue for messages addressed to domains, post offices, or 
gateways that are currently closed. 


A location might be closed because its server is down or because the MTA is unable to communicate 
with it for any other reason. When a closed location is again open, the MTA moves messages from 
the holding queue back into the normal message flow. 


Historical Note: In earlier versions of GroupWise, the Message Transfer Agent (MTA) was called 
the Message Server (MS). Hence, the ms inmshold. Some naming conventions were originally 
preserved for backward compatibility. 


7.3.5 domainms directory 


The domainms subdirectory in the holding directory (shold) is used for internal processing by 
the MTA. It does not contain any files a GroupWise administrator needs to access. 


Historical Note: In earlier versions of GroupWise, the Message Transfer Agent (MTA) was called 
the Message Server (MS). Hence, the ms in domainms. Some naming conventions were originally 
preserved for backward compatibility. 


7.3.6 postx directories 


The postx subdirectories in the holding directory (ms ho1 d) represent post offices in the domain. 
If a post office is closed, the MTA routes messages for that post office into its holding queue in 
mshold. When the post office is open, the MTA moves the messages from the holding queue back 
into the regular message flow. For more information, see “Message Delivery to a Different Post 
Office” on page 19. 


The name of the holding queue for each post office consists of the first three characters of the post 
office name, followed by four hashed characters to ensure uniqueness. 


7.3.7 gatewayx directories 


The gatewayx subdirectories in the holding directory (msho1d) represent gateways in the 
domain. If a gateway is closed, the MTA routes messages for that gateway into its holding queue in 
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mshold. When the gateway is open, the MTA moves the messages from the holding queue back 
into the regular message flow through the gateway. 


The name of the holding queue for each gateway consists of the first three characters of the gateway 
name, followed by four hashed characters to ensure uniqueness. 


7.3.8 domainx directories 


The domainx subdirectories in the holding directory (msho 1d) represent domains to which the 
current domain has a direct link. If a domain is closed, the MTA routes messages for that domain 
into its holding queue in mshold. When the domain is open, the MTA moves the messages from 
the holding queue back into the regular message flow. For more information, see “Message Delivery 
to a Different Domain” on page 27. 


The name of the holding queue for each domain consists of the first three characters of the domain 
name, followed by four hashed characters to ensure uniqueness. 


7.3.9 0-7 directories 


The priority 0-7 subdirectories in each holding queue in the mshold subdirectory correspond to 
the priority 0-7 subdirectories located in each domain, post office, or gateway. See the following 
directory structures for more information about its priority 0-7 subdirectories: 


¢ Section 7.1, “Domain Directory,” on page 63 


¢ Section 7.2, “Post Office Directory,” on page 70 


7.3.10 mtaname files 


The mtaname files in the closed location holding queues provide the name associated with the 
domain, post office, or gateway holding queue. They can help you check links between MTAs in 
ConsoleOne without going to the MTA agent console to determine the location name. To associate a 
location name with its holding queue directory from the MTA agent console, click Configuration 
Status > select the location > click Details. 


7.3.11 gwvsscan directory 


The gwvsscan subdirectory is the working directory where third-party virus scanning programs 
that snap in to the MTA can perform their processing. 


7.3.12 mtaconv directory 
The mtaconv subdirectory is the working directory where the MTA converts GroupWise 7.x, 6.x, 


and 5.x messages to 4.x format for transfer to a Group Wise 4.x system. After the conversion is 
finished, this directory should be empty. 


7.4 Internet Agent Queue Directory 


The following directories and files are found under the \domain\wpgate\ structure for the 
Internet Agent after the software has been installed and the Internet Agent has processed messages. 
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GroupWise Internet Agent home directory 


Internet Agent message processing directory 

Not currently used 

Hold directory for temporary files used during processing 
Log files 

Accounting file 

Settings file for screen colors, log levels, and so on 
Statistics file for Internet Agent operation 

Process lock file indicating that the Internet Agent is running 
Temporary file to verify Internet Agent operation 


MTA input queue directory 
Message priority subdirectories 


MTA output queue 

System-defined directory 

Message priority subdirectories 

Hold directory for damaged outbound messages 


Message hold directory 
Delayed delivery hold directory 


Hold directory for damaged inbound messages 
Directory for character conversion tables 
Directory for old configuration files from reinstalls or upgrades 


Internet Agent configuration file for startup switches 
Route configuration file to customize routing 

Host authentication configuration file 

MIME encoding configuration file for various file types 
Configuration file pointing ConsoleOne to the gwia.cfg file 
Foreign domain name configuration file 

Anti-spam configuration file 


Access control database 
Database dictionary file used to create the access control database 


Message for recipients who lack a MIME-compliant mail reader 
Preamble message in various languages 


List of blocked Internet sites 
File for customizing status messages 


SMTP service (daemon) home directory 


Outbound hold directory for converting messages into Internet format 
Incoming hold directory for converting messages into GroupWise format 
Send and result files to confirm transmission 


Hold directory for re-queued and deferred messages 
Schedule files for SMTP service operations on deferred messages 
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By dsnhold Delivery Status Notification (DSN) hold directory 


7.4.1 domain\wpgate\gwia directory 


The domain\wpgate\ gwia directory is the GroupWise Internet Agent home directory where 
Internet Agent configuration files and queue directories are located. The name is established when 
you install the Internet Agent. The default is wogate\gwia in the domain directory. You can 
change the location using the /home startup switch in the Internet Agent configuration file 


(gwia.cfg). 


000.prc directory 


The Internet Agent uses the 000. prc directory to process messages. 


gwwork directory 


The gwwork directory stores temporary files created by the Internet Agent as it converts and builds 
messages for transfer across the Internet. 


mmddlog.nnn file 


The mmddlog. nnn files hold error and status messages about the functioning of the Internet 
Agent. The Internet Agent creates a log file each day with a unique name, where mm is the month, 
dd is the day, and nnn is a sequential number indicating the sequence of log files in a single day. For 
more information log files, see “Using Internet Agent Log Files” in “Internet Agent” in the 
GroupWise 7 Administration Guide. 


acct file 


The acct file contains information about the messages the Internet Agent sends each day. It is e- 
mailed to the accounts each day at midnight. For more information about the accounting files, see 
“Tracking Internet Traffic with Accounting Data” in “Internet Agent” in the GroupWise 7 
Administration Guide. 


set file 


The set file stores Internet Agent console settings such as color, log settings, and so on. For more 
information, see “Using the Internet Agent Server Console”. 


stat file 


The stat file stores statistics about the Internet Agent’s functioning. For information about the 
statistics provided by the Internet Agent, see “Statistics” in “Internet Agent” in the GroupWise 7 
Administration Guide. 


proc file 


The proc file is the lock file for the Internet Agent process. The proc file is opened and locked 
when the Internet Agent starts. This prevents multiple Internet Agents from being started for the 
same domain. 
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pulse.tmp file 


The pulse . tmp file is re-created by the Internet Agent every time it completes a cycle (after an 
idle loop). If you are not at the Internet Agent console but need to know if the Internet Agent is 
running, you can delete the pulse. tmp file. If the Internet Agent is running, it re-creates the file. 


wpcsin directory 


For a mapped/UNC link, the Internet Agent places inbound messages in one of the wpcsin priority 
subdirectories (0-7). Most messages go in the 4 directory, although some administrative and status 
messages might go in other directories. The Message Transfer Agent retrieves the messages and 
delivers them to the proper destinations. 


For a TCP/IP link, the Internet Agent and the MTA communicate by way of TCP/IP rather than by 
transferring message files. For a comparison, see Chapter 4, “Message Delivery to and from the 
Internet,” on page 35. 


wpcsout directory 


For a mapped/UNC link, the wpcsout directory is the MTA output queue as well as being the 
Internet Agent input queue. 


For a TCP/IP link, the Internet Agent and the MTA communicate by way of TCP/IP rather than by 
transferring message files. For a comparison, see Chapter 4, “Message Delivery to and from the 
Internet,” on page 35. 


gwixxxx directory 


The gwixxxx directory is a system-defined directory, where gwi represents the first three letters of 
the Internet Agent object name as defined during installation and displayed in ConsoleOne, and xxxx 
is a randomly-generated string. Here, the Message Transfer Agent places outbound messages in the 
appropriate 0-7 priority subdirectory for the Internet Agent to retrieve and process. 


problem directory 
The problem directory holds messages that the MTA cannot process. 


You should check this directory periodically for problem files, resolve the problem, then place the 
files back into the appropriate queue for continued processing. For assistance, see “Message Is 
Dropped in the problem Directory in the Domain” in “Strategies for Message Delivery Problems” in 
the GroupWise 7 Troubleshooting 2: Solutions to Common Problems. 


gwhold directory 


The gwhold directory holds messages that are scheduled for delayed delivery. 


qfiles directory 


The qfiles directory holds messages that cannot be sent during the current Send/Receive cycle. 
The messages are queued to this directory until the next cycle. 


The delayed delivery messages waiting in the gfiles directory remain in encrypted format until 
the Internet Agent transfers them to the send directory for processing by the SMTP service. 
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gwprob directory 


The Internet Agent uses the gwprob directory for messages it cannot process. These are usually 
messages that have been damaged during transmission or that contain incorrectly formed MIME 
data. 


These messages cannot be recovered. You can delete them to conserve disk space. 


gwchars directory 


This directory contains conversion tables that the Internet Agent uses to convert message 
attachments between character sets. 


save directory 

If you reinstall or upgrade the Internet Agent, your old configuration files are copied to the save 
directory as a backup. If you reinstall or upgrade repeatedly, the files are overwritten each time. 
gwia.cfg file 


The gwia.cfg file is the Internet Agent configuration file that contains startup switches. Some 
switches are set during installation. You can set others as needed. For more information, see “Using 
Internet Agent Startup Switches” in “Internet Agent” in the GroupWise 7 Administration Guide. 


NetWare: The NetWare Internet Agent uses the gwia.cfq file created in sys: system during 
installation. The gwia.cfg file under the domain is just a boilerplate file with no 
switches set during installation. 


Linux: The Linux Internet Agent uses the gwia.cfg file created in /opt/nove11/ 
groupwise/agents/share during installation. The gwia.cfg file under the domain 
is just a boilerplate file with no switches set during installation. 


Windows: Only the Windows Internet Agent actually uses the gwia.cfg file under the domain. 


route.cfg file 


The route .cfg file enables you to customize routing for specific hosts. For more information, see 
“Using a Route Configuration File” in “Internet Agent” in the GroupWise 7 Administration Guide. 


gwauth.cfg file 


The gwauth.cfg file enables the Internet Agent to log in to SMTP hosts that require 
authentication. For more information, see “SMTP Host Authentication” in “Internet Agent” in the 
GroupWise 7 Administration Guide. 


mimetype.cfg file 


The mimetype . cfg file enables you to customize MIME content-type mappings for various 
attachment types. For more information, see “Customizing MIME Content-Type Mappings” in 
“Internet Agent” in the GroupWise 7 Administration Guide 
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exepath.cfg file 


The exepath.cfg file is used by ConsoleOne to locate the gwia .cfg file. This enables 
ConsoleOne to write any configuration setting changes to the gwia .cfg file or update Novell® 
eDirectory™ with any changes from the file. The file must contain the path to the gwia . cfg file in 
the sys: system directory on NetWare, the /opt /novell/groupwise/agents/share 
directory on Linux, or the domain\wpgate\ gwia directory on Windows. 


frgnames.cfg file 


The frgnames.cfg file lets you list more Internet domain names than can fit in the Foreign ID 
field on the Identification page of the Internet Agent object in ConsoleOne. For more information, 
see “Configuring How the Internet Agent Handles E-Mail Addresses” in “Internet Agent” in the 
GroupWise 7 Administration Guide. 


xspam.cfg file 


The xspam. cfg file lists “X” header fields that your anti-spam service writes to the MIME header, 
along with the values that flag the message as spam. The Internet Agent examines the MIME header 
for any field listed in the xspam.cfg file. When a match occurs, the message is marked for 
handling by the GroupWise client Junk Mail Handling feature. For more information, see 
“Customized Spam Identification” in “Internet Agent” in the GroupWise 7 Administration Guide. 


gwac.db file 


The gwac . db file is the access control database that stores information about the classes of service 
you have created. For more information, see “Maintaining the Access Control Database” in 
“Internet Agent” in the GroupWise 7 Administration Guide. 


gwac.dc file 


The gwac. de file is the data dictionary file from which the gwac. db is created. 


preamble.txt file 


The preamble.txt file is an ASCII text file that is automatically included with any MIME 
multipart message and is displayed when the message recipient lacks a MIME-compliant mail 
reader. For more information, see “Customizing MIME Preamble Text” in “Internet Agent” in the 
GroupWise 7 Administration Guide. 


preamble.all file 


The preamble.al1 file contains the preamble text in multiple languages. For more information, 
see “Customizing MIME Preamble Text” in “Internet Agent” in the GroupWise 7 Administration 
Guide. 


blocked.txt file 


The blocked. txt file contains a list of Internet sites that you have added to the Prevent 
Messages From list for your default class of service in ConsoleOne. For more information, see 
“Controlling User Access to the Internet” in “Internet Agent” in the GroupWise 7 Administration 
Guide. 
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statusxx.xml file 


The statusxx.xml file enables you to customize the messages that users receive regarding 
message delivery status. For more information, see “Customizing Delivery Status Notifications” in 
“Internet Agent” in the GroupWise 7 Administration Guide. 


7.4.2 gwia directory 


The gwia directory is the SMTP service (daemon) home directory where messages are converted 
between GroupWise format and Internet format. On NetWare and Linux, the default location is 
wpgate/gwia, the same as the Internet Agent home directory. On Windows, the default location 
is the Internet Agent installation directory. You can change the location using the /dhome startup 
switch in the Internet Agent configuration file (gwia.cfg). 


send directory 


The Internet Agent SMTP service places outbound messages in the send directory after they have 
been converted out of GroupWise format into SMTP format. The SMTP service polls the send 
directory and sends any messages to the destination SMTP host. 


receive directory 


The Internet Agent SMTP service places inbound messages in the receive directory, converts 
them into GroupWise format, and then passes them to the Message Transfer Agent by placing them 
in the wpcsin directory. 


result directory 


When the Internet Agent SMTP service processes the message, it builds a file, r* . *, in the 
result directory that contains several lines of comments and SMTP reply codes, which might 
indicate possible errors or confirm correct transmission. After the Internet Agent SMTP service has 
completed the transmission with the destination host, it moves another file, s* . * from the send 
directory to the result directory. The filenames for both files are identical, except for the first 
letter, which is either “s” or “r”. The s* . * file is the converted message file. The SMTP service 
looks at the “s” and “r” files in the result directory and compares the conversation. If the r* . * 
file contains the correct (250 OK) SMTP reply codes, the SMTP service deletes the file and sends a 
transferred status message to the user’s Sent Items folder in the GroupWise client. 


defer directory 


The defer directory holds messages that are deferred and re-queued according to the Retry 
Schedule. If the Internet Agent SMTP service receives a temporary error, such as Host Down, it 
places the message in the defer directory for a specified time, then transfers the file to the send 
directory for another attempt at sending to the Internet. For more information, see “Configuring 
Basic SMTP/MIME Settings” in “Internet Agent” in the GroupWise 7 Administration Guide. 


dsnhold directory 


The dsnhold directory stores header information for inbound messages that request delivery status 
notifications. For more information, see “Using Extended SMTP (ESMTP) Options” in “Internet 
Agent” in the GroupWise 7 Administration Guide. 
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7.5 WebAccess Agent Queue Directory 


The following directories and files are found under the \domain\wpgate\ structure for the 
WebAccess Agent after the software has been installed and the WebAccess Agent has processed 
messages. 


E domain\wpgate\webac70a GroupWise WebAccess Agent home directory 


E 000 «pre WebAccess Agent log file processing directory 
= gwwork Hold directory for temporary files used during processing 
LÌ mmddweb. nnn WebAccess Agent log files 
H wocs in MTA input queue directory 
w 0-7 Message priority subdirectories 
T wocsout MTA output queue 
z „Webxxxx System-defined directory for the WebAccess Agent 
x = 0-7 Message priority subdirectories 
z problem Hold directory for damaged outbound messages 
isl gwhold Hold directory for delayed delivery messages 
= gwprob Hold directory for damaged inbound messages 
3 template Directory for templates for viewing documents 
commgr.cfg Communications Manager configuration file 
L] comint. cfg Communications initialization configuration file 
J mimetype.cfg MIME encoding configuration file for various file types 
J gwac.db Access control database 
Ll gwac.dc Database dictionary file used to create the gwac.db file 


7.5.1 domain\wpgate\webac70a directory 


The domainYwpgatel webac70a directory is the WebAccess Agent home directory where 
WebAccess Agent configuration files and queue directories are located. The name is established 
when you install the WebAccess Agent. The default is wogate\webac70a in the domain 
directory. You can change the location using the /home startup switch in the WebAccess Agent 
configuration file (webac70a .waa in the WebAccess A gent installation directory). 


7.5.2 000.prc directory 


The NetWare and Windows WebAccess Agents use the 000 . prc directory to store log files. 


On Linux, the 000. prc directory is located under /var/log. 


mmddlog.nnn file 


The mmddlog. nnn files hold error and status messages about the functioning of the WebAccess 
Agent. The WebAccess Agent creates a log file each day with a unique name, where mm is the 
month, dd is the day, and nnn is a sequential number indicating the sequence of log files in a single 
day. For more information about log files, see “Controlling WebAccess Agent Logging” in 
“WebAccess” in the GroupWise 7 Administration Guide. 


92 GroupWise 7 Troubleshooting 3: Message Flow and Directory Structure 


7.5.3 wpcsin directory 


No longer used. The WebAccess Agent and the MTA communicate by way of TCP/IP and do not 
need queue directories. 


7.5.4 wpcsout directory 


No longer used. 


7.5.5 gwhold directory 


No longer used. 


7.5.6 gwprob directory 


No longer used. 


7.5.7 template directory 


The template directory holds the HTML templates used for viewing documents in HTML 
format. 


7.5.8 commgr.cfg file 


The commgr . cfg file in the WebAccess Agent queue directory contains information for 
communication between the WebAccess Agent and the WebAccess Application, including the IP 
address and port where the WebAccess Agent is running, the number of threads that are running, 
and the encryption key for the WebAccess Agent. This communications information is gathered 
during installation. For more information, see “Configuring the GroupWise Service Provider” in 
“WebAccess” in the GroupWise 7 Administration Guide. 


As part of the installation process, the commgr . cfg file is automatically copied to the Web server 
installation (sys: \novell\webaccess on NetWare, /opt/novell/groupwise/ 
webaccess on Linux, and c: \novel1\webaccess on Windows). The copies are 
synchronized automatically by the WebAccess Application. The commgr . cfg file is also copied to 
the webpublisher subdirectory on the Web server. 


7.5.9 comint.cfg file 


The comint.cfg file in the WebAccess Agent queue directory is read by the WebAccess Agent 
on startup. It contains the same communications information as the commgr . cfg file and is 
synchronized with it automatically. 


7.5.10 mimetype.cfg file 


The mimetype .cfg file enables you to customize MIME content-type mappings for various 
attachment types. The WebAccess Agent handles this just as the Internet Agent does. For more 
information, see “Customizing MIME Content-Type Mappings” in “Internet Agent” in the 
GroupWise 7 Administration Guide 
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7.5.11 gwac.db file 


The gwac. db file is the access control database that stores information about the classes of service 
you have created. For more information, see “Maintaining the Access Database” in “WebAccess” in 
the GroupWise 7 Administration Guide. 


7.5.12 gwac.dc file 


The gwac. dc file is the data dictionary file from which the gwac. db is created. 


7.6 Caching Mailbox Directory 


z] \novell\groupwise\gwxxxxxx GroupWise Caching mailbox 


H rofdata Caching mailbox database directory 
LJ msg.db Cached message database 
Ll user.db Cached user database 
LJ wprof .db Cached Address Book 
Lj wprof.dc Data dictionary for cached Address Book 
J ngwguard. db Guardian database 
ngwguard. dc Data dictionary for guardian database 
ngwguard.rfl Guardian database roll forward log 
ngwguard. fbk Guardian database “fall back” file 
O puxxxxx.db Database for shared folders 
Ll ngwcheck. db GroupWise Check database 
J gwcheckn. log Log file created by the Repair Mailbox feature 
En gwdms Document Management Services directory 
LÌ amsh.db Shared DMS database 
J dmxxnn01-FF.db Document databases 
= docs Subdirectory for documents in the Caching mailbox 
H index QuickFinder index for documents in the Caching mailbox 
3 index QuickFinder index for messages in the Caching mailbox 
a wpcsin Input queue for the Caching mailbox 
Be 0-7 Priority subdirectories 
T wocsout \ofs Output queue for the Caching mailbox 
w 0-7 Priority subdirectories 
w wpgwsend Output queue to the Online mailbox 
wpgwrecv Input queue from the Online mailbox 
LÌ remoten. log Connection log 
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7.6.1 Inovelhgroupwiselgwxxxxxx directory 


Your GroupWise Caching mailbox is a directory structure that functions similarly to a post office. 
Like a post office, it contains databases and input/output queues. It is created in the directory where 
the GroupWise client is installed, which is typically \novell\groupwise. 


The same directory structure is used for a Caching mailbox as for a Remote mailbox. However, a 
Caching mailbox is a complete copy of your Online mailbox, but you can restrict what gets 
downloaded into your Remote mailbox. 


7.6.2 rofdata directory 


The rofdata directory contains the databases accessed by the GroupWise Windows client when 
running in Caching mode. The databases in rofdata are similar to the databases found in post 
offices. For comparison, see Section 7.2, “Post Office Directory,” on page 70. 


Historical Note: An earlier version of the GroupWise client Remote mode, designed by WordPerfect 
Corporation (WPCorp), was named WP Office Remote. Hence, the rof in rofdata. Some 
naming conventions were originally preserved for backward compatibility. 


msg.db file 


The msg. db file is the cached equivalent of the msgnnn. db files in the ofmsg directory in your 
post office. The msg. db file contains copies of messages from your Online mailbox. 


user.db file 


The user. db file is the cached equivalent of the userxxx. db files in the ofuser directory in 
your post office. 


wprof.db file 
The wprof . db file contains the cached version of the GroupWise Address Book. 


Historical Note: An earlier version of the GroupWise client Remote mode, designed by WordPerfect 
Corporation (WPCorp), was named WP Office Remote. Hence, the wprof in wprof . db. Some 
naming conventions have been preserved for backward compatibility. 


wprof.dc file 
The wprof . dae file is the data dictionary for the cached Address Book (wprof.db). 


Historical Note: An earlier version of the GroupWise client Remote mode, designed by WordPerfect 
Corporation (WPCorp), was named WP Office Remote. Hence, the worof in wprof .dc. Some 
naming conventions have been preserved for backward compatibility. 


ngwguard.db file 


The ngwguard. db file is the guardian database for your Caching mailbox. It is parallel in function 
to the ngwguard. db file in the post office. 
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ngwguard.dc file 


The ngwguard. dc file is the data dictionary for building the databases in the GroupWise Caching 
mailbox. It is parallel in function to the ngwguard. dc file in the post office. 


ngwguard.rfl file 


The ngwguard.rf1 file is a roll-forward transaction log of every database transaction that has 
taken place since the last copy of the ngwguard. fbk file was created. It is parallel in function to 
the ngwguard.rf1 file in the post office. 


ngwguard.fbk 


The ngwguard. fbk file “fall back” copy of the ngwguard. db file. It is parallel in function to 
the ngwguard. fbk file in the post office. 


puxxxxx.db files 


The puxxxxx. db files are databases for replicated items such as shared folders. These databases 
prevent conflicts between user names of shared items from users in other post offices and user 
names in your own post office. They are parallel to the puxxxxx. db files in the post office. 


ngwcheck.db file 


The ngwcheck. db file tracks GroupWise Check threads and the databases being checked. In the 
GroupWise client, GroupWise Check is run using Tools > Repair Mailbox. 


gwcheckn.log 


The gwcheckn. log file records any errors that occurred during mailbox repair. For assistance 
with GroupWise Check errors, see “GroupWise Check Error Codes” in “Administration Error 
Messages” in the GroupWise 7 Troubleshooting 1: Error Messages. 


gwdms directory 


The gwdms directory is the Document Management Services directory. It contains information 
about the libraries in your Group Wise system. It has the same structure as the gwdms subdirectory 
in the post office. 


dmsh.db file 


The dmsh. db file is a database shared by all libraries that contains a list of all available libraries 
and lookup tables for each library. 


dmxxnn01-FF.db files 


The dmxxnn01-FF. db files are databases for library and document information. They are parallel 
to the damxxnn01-=FF. db files in the post office. 


docs directory 


The docs directory holds cached copies of the documents in your Online mailbox. 
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index directory 


The index directory under the gwdms directory contains the QuickFinder index for the documents 
in your Caching mailbox. 


index directory 


The index directory under the rofdata directory contains the QuickFinder index for the 
messages in your Caching mailbox. 


7.6.3 wpcsin directory 


The wpcsin subdirectory is the input queue for the connection that transfers messages to your 
GroupWise system for delivery. Messages from the GroupWise client in Caching mode are 
processed through the priority 1 subdirectory of wocsin. 


When you send a message in Caching mode, the GroupWise client connects to your GroupWise 
system. It polls the wocsin\1 directory and compresses any outgoing messages, requests, or both 
into a file. If the compressed file totals over 50 KB, additional compressed files are created. The 
Group Wise client then moves the compressed files into the wogwsend directory. 


Historical Note: WP Office, the predecessor of Group Wise, was originally designed by WordPerfect 
Corporation (WPCorp). The Message Transfer Agent (MTA) was originally named the Connection 
Server (CS). Hence, the directory name wpcsin for the input queue, although the MTA is not 
involved in processing messages in your Caching mailbox. Some naming conventions were 
originally preserved for backward compatibility. 


0-7 directories 


The priority 0-7 subdirectories in the connection input queue (wpcsin) parallel those found in the 
wpcsin directory in your post office. 


7.6.4 wpcsoutiofs directory 


The wpcsout\ofs directory is the output queue for the connection that transfers messages from 
your Online mailbox. Messages from your GroupWise system are processed through the priority 1 
subdirectory of wocsout\ofs. 


The GroupWise client scans the wocsout\ofs\1 subdirectory and updates the user . db and 
msg. db files with the information received from your Online mailbox. 


Historical Note: WP Office, the predecessor of GroupWise, was originally designed by WordPerfect 
Corporation (WPCorp). The Message Transfer Agent (MTA) was originally named the Connection 
Server (CS). Hence, the directory names wpcsin and ofs for the input queue, though the MTA is 
not involved in processing messages in your Remote mailbox. Some naming conventions were 
originally preserved for backward compatibility. 


0-7 directories 


The priority 0-7 subdirectories in the connection output queue (wpcsout \ofs) parallel those 
found in the ofs directory in your post office. 
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7.6.5 wpgwsend directory 


The wegwsend directory holds compressed files that contain outgoing messages, requests, or both. 
When a connection to your Group Wise system is established, the Group Wise client uploads the files 
to your Online mailbox. 


Historical Note: WP Office Remote, the predecessor of the GroupWise client Remote mode, was 
originally designed by WordPerfect Corporation (WPCorp). Hence, the name wogwsend. Some 
naming conventions were originally preserved for backward compatibility. 


7.6.6 wpgwrecv directory 


The wpgwrecv directory holds compressed files that contain messages or other information that 
have been received from your Online mailbox. The GroupWise client decompresses the files and 
places the message files into the wocsout\ofs\1 directory. 


Historical Note: WP Office Remote, the predecessor of the GroupWise client Remote mode, was 
originally designed by WordPerfect Corporation (WPCorp). Hence, the name wogwrecv. Some 
naming conventions were originally preserved for backward compatibility. 


7.6.7 remoten.log 
The remoten. log files are saved versions of the connection logs you can view in the Group Wise 


client by clicking Accounts > Connection Log. These log files can be useful for troubleshooting 
problems with your connection to your Online mailbox. 


7.7 Remote Mailbox Directory 


= remote _ mailbox 
H rofdata 


GroupWise mailbox on a remote computer 


Remote database directory 


J msg.db Remote message database 

LÌ user.db Remote user database 

LJ wprof.db Remote Address Book 

LJ wprof.dc Data dictionary for Remote Address Book 


J ngwguard. db 
ngwguard.dc 
ngwguard.rfl 
ngwguard. fbk 


LJ PUXXXXxX.db 


L] ngwcheck. db 
LJ gwcheckn.log 
E] gwdms 

LÌ amsh.db 


7 dmxxnn01-FF. db 


=) docs 
El index 


Remote guardian database 

Data dictionary for Remote guardian database 
Guardian database roll forward log 

Guardian database “fall back” file 


Database for shared folders 


GroupWise Check database 
Log file created by the Repair Mailbox feature 


Document Management Services directory 

Shared DMS database 

Document databases 

Subdirectory for documents in the Remote mailbox 
QuickFinder index for Remote mailbox 
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E index QuickFinder index for messages in the Remote mailbox 


Ba wpcsin Input queue for the GroupWise client in Remote mode 
w 0-7 Priority subdirectories 

T wocsout \ofs Output queue for the GroupWise client in Remote mode 
Bl 0-7 Priority subdirectories 

a wpgwsend Output queue to master mailbox 
wpgwrecv Input queue from master mailbox 

LÌ remoten. log Remote connection log 


7.7.1 remote_mailbox directory 


The GroupWise remote mailbox is a directory structure that functions similarly to a post office. Like 
a post office, it contains databases and input/output queues. 


7.7.2 rofdata directory 


The rofdata subdirectory in the remote mailbox directory contains the databases accessed by the 
Group Wise client in Remote mode. The databases in rofdata are similar to the databases found in 
post offices. 


Historical Note: An earlier version of the GroupWise client Remote mode, designed by WordPerfect 
Corporation (WPCorp), was named WP Office Remote. Hence, the rof in rofdata. Some 
naming conventions were originally preserved for backward compatibility. 


msg.db file 


The msg. db file in the remote data directory (rofdata) in the remote mailbox directory is the 
remote equivalent of the msgnnn. db files in the ofmsg directory in the post office where your 
master mailbox is located. The msg. db file contains messages you have downloaded from your 
master mailbox. 


user.db file 


The user. db file in the remote data directory (rofdata) in the remote mailbox directory is the 
remote equivalent of the userxxx. db files in the ofuser directory in the post office where your 
master mailbox is located. The user . db file contains user information you have downloaded from 
your master mailbox. 


wprof.db file 


The wprof . db file in the remote data directory (rofdata) in the Remote mailbox directory 
contains the remote version of the GroupWise Address Book if you have downloaded it. 


Historical Note: An earlier version of the GroupWise client Remote mode, designed by WordPerfect 
Corporation (WPCorp), was named WP Office Remote. Hence, the worof in wprof.db. Some 
naming conventions have been preserved for backward compatibility. 
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wprof.dc file 


The wprof . da file in the remote data directory (rofdata) in the Remote mailbox directory is the 
data dictionary for the remote Address Book (wprof . db). 


Historical Note: An earlier version of the GroupWise client Remote mode, designed by WordPerfect 
Corporation (WPCorp), was named WP Office Remote. Hence, the worof in worof.dc. Some 
naming conventions have been preserved for backward compatibility. 


ngwguard.db file 


The ngwguard. db file in the remote data directory (rofdata) in the Remote mailbox directory 
is the guardian database for the remote GroupWise mailbox. It is parallel in function to the 
ngwguard. db file in the post office. 


ngwguard.dc file 


The ngwguard. dc file in the remote data directory (rofdata) in the Remote mailbox directory 
is the data dictionary for building the databases in the remote Group Wise mailbox. It is parallel in 
function to the ngwguard. dc file in the post office. 


ngwguard.rfl file 


The ngwguard. rfl file is a roll-forward transaction log of every database transaction that has 
taken place since the last copy of the ngwguard. fbk file was created. It is parallel in function to 
the ngwguard.rf1 file in the post office. 


ngwguard.fbk 


The ngwguard. fbk file “fall back” copy of the ngwguard. db file. It is parallel in function to 
the ngwguard. fbk file in the post office. 


puxxxxx.db files 


The puxxxxx.db files in the remote data directory (rofdata) in the Remote mailbox directory 
are databases for replicated items such as shared folders. These databases prevent conflicts between 
user names of shared items from users in other post offices and user names in the Remote user’s post 
office. They are parallel to the puxxxxx. db files in the post office. 


ngwcheck.db file 


The ngwcheck. db file tracks GroupWise Check threads and the databases being checked. In 
Remote mode in the GroupWise client, GroupWise Check is run using Tools > Repair Mailbox. 


gwcheckn.log 


The gwcheckn. log file records any errors that occurred during Remote mailbox repair. For 
assistance with GroupWise Check errors, see “GroupWise Check Error Codes” in “Administration 
Error Messages” in the GroupWise 7 Troubleshooting 1: Error Messages. 
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gwdms directory 


The gwdms subdirectory in the remote data directory (rofdata) in the remote mailbox directory is 
the Document Management Services directory. It contains the document libraries you have 
downloaded from your master GroupWise system. It has the same structure as the gwdms 
subdirectory in the post office. 


dmsh.db file 


The dmsh. db file is a database shared by all libraries that have been downloaded to your remote 
Group Wise mailbox. It contains a list of all available libraries and lookup tables for each library. 


dmxxnn01-FF.db files 


The dmxxnn01-FF. db files are databases for library and document information. They are parallel 
to the dmxxnn01-FF. db files in the post office. 


docs directory 


The docs directory holds cached copies ofthe documents in your Remote mailbox. 


index directory 


The index directory contains the QuickFinder index for the documents contained in the library. 


index directory 


The index directory under the rofdata directory contains the QuickFinder index for the 
messages in your Remote mailbox. 


7.7.3 wpcsin directory 


The wpcsin subdirectory in the remote mailbox directory is the input queue for the connection that 
transfers messages to your master GroupWise system. Messages from the GroupWise client in 
Remote mode are processed through the priority 1 subdirectory of wpcsin. 


When the user initiates the connection to the master Group Wise system, the GroupWise client polls 
the wocsin! 1 directory and compresses the outgoing messages, requests, or both into a file. If the 
compressed file totals over 50 KB, additional compressed files are created. The GroupWise client 
then moves the compressed files into the wogwsend directory. 


Historical Note: WP Office, the predecessor of Group Wise, was originally designed by WordPerfect 
Corporation (WPCorp). The Message Transfer Agent (MTA) was originally named the Connection 
Server (CS). Hence, the directory name wpcsin for the input queue, although the MTA is not 
involved in processing messages in your Remote mailbox. Some naming conventions were 
originally preserved for backward compatibility. 


0-7 directories 


The priority 0-7 subdirectories in the connection input queue (wecs in) in the remote mailbox 
directory parallel those found in the wocsin directory in the remote user’s post office on the master 
Group Wise system. 
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7.7.4 wpcesoutlofs directory 


The wocsout\ofs subdirectory in the remote mailbox directory is the output queue for the 
connection that transfers messages from your master GroupWise system. Messages from the 
Group Wise client in Remote mode are processed through the priority 1 subdirectory of wpcsout\ofs. 


In Remote mode, the GroupWise client scans the wocsout\ofs\1 subdirectory and updates the 
user.db and msg. db files with the information received from the master mailbox. 


Historical Note: WP Office, the predecessor of GroupWise, was originally designed by WordPerfect 
Corporation (WPCorp). The Message Transfer Agent (MTA) was originally named the Connection 
Server (CS). Hence, the directory names wpcsin and ofs for the input queue, though the MTA is 
not involved in processing messages in your Remote mailbox. Some naming conventions were 
originally preserved for backward compatibility. 


0-7 directories 


The priority 0-7 subdirectories in the connection output queue (wpcsout \ofs) in the remote 
mailbox directory parallel those found in the o fs subdirectory in the remote user’s post office on 
the master Group Wise system. 


7.7.5 wpgwsend directory 


The wogwsend subdirectory in the remote mailbox directory holds compressed files that contain 
outgoing messages, requests, or both. When a connection to your master GroupWise system is 
established, the GroupWise client uploads the files across the link from the remote computer to the 
master GroupWise system. 


Historical Note: WP Office Remote, the predecessor of the GroupWise client Remote mode, was 
originally designed by WordPerfect Corporation (WPCorp). Hence, the name wogwsend. Some 
naming conventions were originally preserved for backward compatibility. 


7.7.6 wpgwrecv directory 


The wegwrecv subdirectory in the remote mailbox directory holds compressed files that contain 
messages or other information that have been downloaded from your master mailbox. The 
GroupWise client decompresses the files and places the message files into the wocsout\ofs\1 
directory. 


Historical Note: WP Office Remote, the predecessor of the GroupWise client Remote mode, was 
originally designed by WordPerfect Corporation (WPCorp). Hence, the name wogwrecv. Some 
naming conventions were originally preserved for backward compatibility. 


7.7.7 remoten.log 


The remoten.1log files in the connection output queue (wocsout\ofs) in the remote mailbox 
directory are saved versions of the connection logs you can view in the GroupWise client in Remote 
mode. These log files can be useful for troubleshooting problems with your modem or with your 
connection to your master GroupWise system. 
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Agent Installation Directories 


+ Section 8.1, “GroupWise Agent Installation (POA and MTA),” on page 103 


¢ Section 8.2, “Internet Agent Installation,” on page 114 


+ 


Section 8.3, “WebAccess Agent Installation,” on page 121 
+ Section 8.4, “Monitor Agent Installation,” on page 133 


° 


Section 8.5, “Apache/Tomcat Installation,” on page 137 


8.1 GroupWise Agent Installation (POA and 
MTA) 


The Post Office Agent (POA) and the Message Transfer Agent (MTA) are always installed together. 
The agent installation directory differs depending on the platform where the agents are installed. 


¢ Section 8.1.1, “NetWare Installation Directory,” on page 103 
¢ Section 8.1.2, “Linux Installation Directory,” on page 106 


+ Section 8.1.3, “Windows Installation Directory,” on page 111 


8.1.1 NetWare Installation Directory 


E sys:\system NetWare® agent installation directory 

LJ gwenn5.nlm GroupWise® 7.x Agent Engine 

LJ gwpoa.nlm Post Office Agent (POA) program 
gwmta.nlm Message Transfer Agent (MTA) program 

J strtupxx.poa Boilerplate POA startup file 

J strtupxx.mta Boilerplate MTA startup file 

Lj post office.poa POA startup file for a specific post office 

LÌ domain.mta MTA startup file for a specific domain 

L] gwpoanxx.hlp POA online help files 
gwmtanxx.hlp MTA online help files 

J gwpoanxx.fil POA language information files 

J gwmtanxx.fil MTA language information files 

LJ grpwise.ncf Agent load file 

L] x*5.nim XIS NLM™ programs 

J gwxis12.nlm GroupWise XIS NLM program 

Ll agent.xml XIS agent configuration files 

E gwtsa.nlm GroupWise Target Service Agent (GWTSA) program 

_] gwtsaxx. fil GWTSA language information files 

Ll ywtsa.ncf GWTSA load file 
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LJ gwtmstmp.nlm GroupWise Time Stamp program 
J dbcopy.nlm GroupWise Database Copy program 


3 help Subdirectory for GroupWise agent Web console help files 


NetWare agent installation directory 


When you first install GroupWise Administration, the GroupWise agents are installed in platform- 
specific subdirectories in the agent directory in the software distribution directory. However, the 
agents cannot be run from this initial location. They must be installed on the servers where they will 
run. 


On a NetWare? server, the GroupWise agents are typically installed in the sys: system 
directory. You can choose a different location during installation. 


gwenn5.nIm file 


The gwenn5.n1m file is the GroupWise 7.x Agent Engine, a program that is shared by all 
GroupWise agents. It provides the following services to the agents: 

+ Database management 

¢ File operations 

+ Message handling 

+ Thread management 

+ Semaphores (file/record locking) 


+ Date/time services 


The first agent loaded on a server automatically loads the GroupWise A gent Engine. 


gwpoa.nim file 


The gwpoa . n]m file is the Post Office Agent program. You load this NLM program to start the 
Post Office Agent. See “Starting the NetWare GroupWise Agents” in “Installing GroupWise 
Agents” in the GroupWise 7 Installation Guide. 


gwmta.nIm file 


The gwmta .nlmis the Message Transfer Agent program. You load this NLM program to start the 
Message Transfer Agent. See “Starting the NetWare GroupWise Agents” in “Installing GroupWise 
Agents” in the GroupWise 7 Installation Guide. 


strtupxx.poa file 


The POA startup file contains startup switches for the POA. Switch settings placed in the POA 
startup file override comparable options set for the POA in ConsoleOne®. The xx in the startup 
filename represents a two-letter language code. 


During installation, a customized version of the POA startup file, named post office.poa,is 
created. This customized version has the /home startup switch automatically set to the post office 
directory the POA will service. See “Using POA Startup Switches” in “Post Office Agent” in the 
GroupWise 7 Administration Guide. 
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strtupxx.mta file 


The MTA startup file contains startup switches for the MTA. Switch settings placed in the MTA 
startup file override comparable options set for the MTA in ConsoleOne. The xx in the startup 
filename represents a two-letter language code. 


During installation, a customized version of the MTA startup file, named domain.mta, is created. 
This customized version has the /home startup switch automatically set to the domain directory the 
MTA will service. See “Using MTA Startup Switches” in “Message Transfer Agent” in the 
GroupWise 7 Administration Guide. 


nlm_agentnxx.hlp files 


Online help is available by pressing F1 at the agent console on the server where it runs. See “Using 
the POA Server Console” in “Post Office Agent” and “Using the MTA Server Console” in 
“Message Transfer Agent” in the GroupWise 7 Administration Guide 


The first five characters of the filename are the agent name. The digit n is a version number. The last 
two characters xx are a language code. 


nlm_agentnxx.fil files 


These files contain all language-specific information for the POA and the MTA. The first five 
characters of the filename are the agent name. The digit n is a version number. The last two 
characters xx are a language code. 


grpwise.ncf file 


The grpwise.ncf file is the NetWare configuration file that automatically loads the agents 
whenever the server is restarted. A typical grpwise.ncf file would look similar to the following: 


load sys:\system\gwmta.nlm @corpdom.mta 
load sys:\system\gwpoa.nlm @acctpo.poa 


For more information, see “Starting the NetWare GroupWise Agents” in “Installing Group Wise 
Agents” in the GroupWise 7 Installation Guide. 


x*5.nlm and gwxis12.nIm files 


The x*5.n1m and gwxis12.n1m programs provide XIS capability for the GroupWise agents, so 
that you can create XML documents to monitor and change the agents as needed. 


nlm_agent.xml files 


The nlm agent.xml files are specialized agent configuration files for use in the XIS 
environment. 


gwtsa.nlm file 


The gwtsa.nl1m file is the GroupWise Target Service Agent (GWTSA), which provides reliable 
backups of a running GroupWise system by successfully backing up open files and locked files, 
rather than skipping them as some backup software does. For more information, see “GroupWise 
Target Service Agent (GWTSA) for NetWare 5.1” in “Databases” in the GroupWise 7 
Administration Guide. 
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gwtmstmp.nim file 


If you use the GroupWise Target Service Agent (GWTSA) of the GroupWise Target Server Agent 
for File Systems (TSAFSGW) to back up your GroupWise system, the time stamping is an 
automatic part of the backup process. However, if you choose not to use one of these TSAs, you 
must still make sure that user databases are time-stamped so that items are not prematurely purged. 
The gwtms tmp . nlm accomplishes this task. For more information, see “GroupWise Time Stamp 
Utility” in “Databases” in the GroupWise 7 Administration Guide. 


dbcopy.nIm file 


The dbcopy.nlm file is the GroupWise Database Copy utility, which copies files from a live 
Group Wise post office or domain to a static location for backup. During the copy process, DBCopy 
prevents the files from being modified, using the same locking mechanism used by other GroupWise 
programs that access databases. This ensures that the backed-up versions are consistent with the 
originals even when large databases take a substantial amount of time to copy. For more 
information, see “GroupWise Database Copy Utility” in “Databases” in the GroupWise 7 
Administration Guide. 


gwtsaxx.fil file 


These files contain all language-specific information for the GWTSA. The last two characters, xx, 
are a language code. 


gwtsa.ncf file 


The gwtsa.ncf file is the NetWare configuration file that automatically loads the GWTSA 
whenever the server is restarted. A typical gwtsa.ncf file would look similar to the following: 
load sys:\system\smdr 
load sys:\system\gwtsa /home-sys:\gwsystem\corpdom 

/home-sys: \gwsystem\acctpo 


help directory 


The help directory contains language-specific subdirectories for the help files available from the 
POA and MTA Web consoles. See “Using the POA Web Console” in “Post Office Agent” and 
“Using the MTA Web Console” in “Message Transfer Agent” in the GroupWise 7 Administration 
Guide. 


8.1.2 Linux Installation Directory 


w, opt/novell/groupwise/agents Linux agent installation directory 


y bin Subdirectory for GroupWise agent executables 
O gwpoa Post Office Agent (POA) executable 
gwmta Message Transfer Agent (MTA) executable 
gwha GroupWise High Availability service executable 
L] owpoa.xml POA XIS configuration file 
gwmta.xml MTA XIS configuration file 


106 GroupWise 7 Troubleshooting 3: Message Flow and Directory Structure 


J Strtupxx.poa 


strtupxx.mta 


LI gwesrgen 
gwtmstmp 


Mio 
úl gwpoaxxx. fil 


gwmtaxxx. fil 


J libpoa.so* 
libpoa_ui.so* 
libmta.so* 
libmta wi.so* 


LJ libgwha.so* 


LJ * Sow 
= image 
z share 


post_office.poa 


domain.mta 


z qgwcsrgen 


Z help 


BY /etc/init.d 
LJ grpwise 


= HOD. 


J S99grpwise 


rend 
J S99grpwise 


Wl /etc/opt 
z novell/groupwise 


m gwha.conf 


a agents 
| uid cont 


2 


/var/log/ 
= novell/groupwise 


Boilerplate POA startup file 
Boilerplate MTA startup file 


GroupWise Generate CSR utility 
GroupWise Time Stamp utility 


Subdirectory for GroupWise agent library files 
POA language information file 
MTA language information file 


POA shared library files 

POA shared library files for the optional user interface 
MTA-specific library files 

MTA-specific library files for the optional user interface 
GroupWise High Availability service library files 
Supporting library files 


Subdirectory for icon images 
Subdirectory for agent shared files 


POA startup file for a specific post office 
MTA startup file for a specific domain 


Subdirectory for agent console files 
Subdirectory agent console help files 


Subdirectory for agent Web console files 
Subdirectory for agent Web console help files 


Subdirectory for the GWCSRGEN utility files 
Subdirectory for GWCSRGEN utility help files 


Standard Linux location for application startup scripts 
Startup script for the POA and MTA 


Standard Linux location for runlevel-3 symbolic links 
Symbolic link to the startup script for the POA and MTA 


Standard Linux location for runlevel-5 symbolic links 
Symbolic link to the startup script for the POA and MTA 


Standard Linux location for application configuration files 
Subdirectory for GroupWise configuration files 
GroupWise High Availability service configuration file 


Subdirectory for GroupWise agents 
Agent configuration file for running as a non-root user 


Standard Linux location for application log files 
Subdirectory for GroupWise agent log files 
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3 post _office.poa Post office-specific subdirectory for POA log files 


Ll mmddpoa.nnn POA log files 
3 domain.mta Domain-specific subdirectory for MTA log files 
LÌ mmdamta. nnn MTA log files 


agents directory 

On a Linux server, the agents are always installed in subdirectories of /opt/novell/ 
groupwise/agents. 

bin directory 

The bin directory holds GroupWise executable files. 

gwpoa file 


The gwpoa file is the Post Office Agent executable. You run this executable file to start the Post 
Office Agent. See “Starting the Linux Agents with a User Interface” in “Installing Group Wise 
Agents” in the GroupWise 7 Installation Guide. 


gwmta file 


The gwmta file is the Message Transfer Agent executable. You run this executable file to start the 
Message Transfer Agent. See “Starting the Linux Agents with a User Interface” in “Installing 
GroupWise Agents” in the GroupWise 7 Installation Guide. 


gwha file 


The gwha file is the GroupWise High Availability service executable. If the POA or the MTA goes 
down for any reason, the High Availability service automatically restarts it. See “Enabling the High 
Availability Service for the Linux GroupWise Agents” in “Installing GroupWise Agents” in the 
GroupWise 7 Installation Guide. 


* xml files 


The agent .xml files are specialized agent configuration files for use in the XIS environment. 


strtupxx.poa file 


The strtupxx. poa file is the boilerplate file from which a post office-specific 
post office.poa file is created in the share directory. The xx in the startup filename 
represents a two-letter language code. 


strtupxx.mta file 


The strtupxx.mta file is the boilerplate file from which a domain-specific domain. poa file is 
created in the share directory. The xx in the startup filename represents a two-letter language code. 


gwcsrgen file 


The gwesrgen file is the GroupWise Generate CSR utility. If you enable SSL for the agents, they 
need access to a server certificate and private key. You can use the GroupWise Generate CSR utility 
(GWCSRGEN) to generate a Certificate Signing Request (CSR) file and a Private Key file. For 
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more information, see “Server Certificates and SSL Encryption” in “Security Administration” in the 
GroupWise 7 Administration Guide. 


gwtmstmp file 


The gwtmstmp file is the GroupWise Time Stamp utility. If you deselect Allow Purge of Items Not 
Backed Up in ConsoleOne, user databases (use rxxx . db) must be time-stamped every time a 
backup is performed so that items can be purged only after being backed up. You can use the 

Group Wise Time Stamp (GWTMSTMP) utility to ensure that Group Wise user databases include the 
dates when they were last backed up, restored, and retained. For more information, see “Group Wise 
Time Stamp Utility” in “Databases” in the GroupWise 7 Administration Guide. 


lib directory 


The 1ib directory holds GroupWise library files. 


* fil files 


These files contain all language-specific information for the POA and the MTA. The first five 
characters of the filename are the agent name. The last two characters xx are a language code. 


*.so* files 
These files are Linux library files that provide information to the GroupWise executables. 
image directory 


The image directory has subdirectories for agent icons for both color and monochrome displays. 


share directory 


The share directory holds agent startup files and files that are used by the agent consoles and Web 
consoles. 


post_office.poa 


The POA startup file contains startup switches for the POA. Switch settings placed in the POA 
startup file override comparable options set for the POA in ConsoleOne. 


During installation, a customized version of the st rtupxx.poa file, named 

post office.poa, is created in the share directory. This customized version has the --home 
startup switch automatically set to the post office directory the POA will service. See “Using POA 
Startup Switches” in “Post Office Agent” in the GroupWise 7 Administration Guide. 


domain.mta 


The MTA startup file contains startup switches for the MTA. Switch settings placed in the MTA 
startup file override comparable options set for the MTA in ConsoleOne. 


During installation, a customized version of the st rtupxx.mta file, named domain.mta, is 
created in the share directory. This customized version has the --home startup switch 
automatically set to the domain directory the MTA will service. See “Using MTA Startup Switches” 
in “Message Transfer Agent” in the GroupWise 7 Administration Guide. 
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agtcon directory 


The agtcon directory holds subdirectories and files used by the agent consoles, such as help files. 
See “Using the POA Server Console” in “Post Office Agent” and “Using the MTA Server Console” 
in “Message Transfer Agent” in the GroupWise 7 Administration Guide. 


webcon directory 


The webcon directory holds subdirectories and files used by the agent Web consoles, such as help 
files. See “Using the POA Web Console” in “Post Office Agent” and “Using the MTA Web 
Console” in “Message Transfer Agent” in the GroupWise 7 Administration Guide. 


gwesrgen directory 


The gwcsrgen directory holds subdirectories and files used by the GroupWise Generate CSR 
(GWCSRGEN) utility, such as help files. See “Generating a Certificate Signing Request and Private 
Key” in “Security Administration” in the GroupWise 7 Administration Guide. 


letc/init.d directory 


The /etc/init.d directory is the standard location for Linux startup scripts. 
grpwise file 


The grpwise script is created automatically during installation. You can use the script to start, 
restart, stop, and display status information about the POA and MTA. For more information about 
starting the agents, see “Installing and Starting the Linux GroupWise Agents” in “Installing a Basic 
GroupWise System” in the GroupWise 7 Installation Guide. 


rc3.d directory 


The rc3.d directory holds symbolic links to scripts that you want your Linux server to run when it 
is booted to runlevel 3 (multi-user; boots to a text mode login prompt without the X Window 
System*). The symbolic link to the grpwise script is S99grpwise. It is created if you choose 
during installation to have the agents start automatically when the server boots. See “Starting the 
Linux GroupWise Agents on System Startup” in “Installing GroupWise Agents” in the GroupWise 7 
Installation Guide. 


rc5.d directory 


The rc5 .d directory holds symbolic links to scripts that you want your Linux server to run when it 
1s booted to runlevel 5 (multi-user; boots to the X Window System login dialog box). The symbolic 
link to the grpwise script is S99grpwise. It is created if you choose during installation to have 
the agents start automatically when the server boots. See “Starting the Linux GroupWise Agents on 
System Startup” in “Installing GroupWise Agents” in the GroupWise 7 Installation Guide. 


letc/opt/novell/groupwise directory 


The /etc/opt directory is the standard location of application configuration files on Linux. Files 
that configure how the GroupWise agents interact with Linux are stored in the novel1/ 
groupwise subdirectory. 
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gwha.conf file 


The gwha . conf file is the GroupWise High Availability service configuration file. It is created 
automatically during installation and provides the information necessary for the High Availability 
service to restart the Group Wise agents if they go down unexpectedly. See “Enabling the High 
Availability Service for the Linux GroupWise Agents” in “Installing GroupWise Agents” in the 
GroupWise 7 Installation Guide. 


uid.conf file 


The uid.conf file configures the GroupWise agents to run as a non-root user. See “Running the 
Linux GroupWise Agents as a Non-root User” in “Installing GroupWise Agents” in the Group Wise 
7 Installation Guide. 


Ivar/log/novell/groupwise directory 


The /var/ log directory is the standard location for log files on Linux. All GroupWise agent log 
files are created in the nove11/groupwise subdirectory. 


post_office.poa directory 
The post_office.poa directory is a post office-specific location for POA log files. 


Within the post_office.poa directory, the POA creates log files (mmddpoa . nnn) to inform 
you of its processing and any problems it encounters. For more information about log files, see 
“Using POA Log Files” in “Post Office Agent” in the GroupWise 7 Administration Guide guide. 


The first two digits of the filename represent the month, the next two digits represent the day of the 
month, and the next three characters indicate what program created the log. The three-digit 
extension is a sequence number for multiple log files created on the same day. For example, 
0518poa.002 is the second POA log file created on May 18. 


domain.mta directory 
The domain.mta directory is a domain-specific location for MTA log files. 


Within the domain.mta directory, the MTA creates log files (mmddxxx. nnn) to inform you of 
its processing and any problems it encounters. For more information about log files, see “Using 
MTA Log Files” in “Message Transfer Agent” in the GroupWise 7 Administration Guide. 


The first two digits of the filename represent the month; the next two digits represent the day of the 
month; the next three characters indicate what program created the log. The three-digit extension is 
a sequence number for multiple log files created on the same day. For example, 0518mta.002 is 
the second MTA log file created on May 18. 


8.1.3 Windows Installation Directory 


w c:\grpwise Windows agent installation directory 
J gwenvla.dll GroupWise Agent Engine 
L gwpoa.exe Post Office Agent (POA) program 
J gwmta.exe Message Transfer Agent (MTA) program 
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J strtupxx.poa Boilerplate POA startup file 





LJ strtupxx.mta Boilerplate MTA startup file 

LJ post_office.poa Customized POA startup file 

LÌ domain.mta Customized MTA startup file 

Ll post_office.poa POA startup file for a specific post office 

LÌ domain.mta MTA startup file for a specific domain 

LÌ gwpoanxx.chm POA online help file 
gwmtanxx.chm MTA online help file 

LJ gwpoanxx.dl1l POA language information files 
gwmtanxx.d1l MTA language information files 

LJ gwsnmp.dl1l Customized DLL program for SNMP 

LJ gwwwwl.dl1l Customized DLL program for MIME 

L x*10a.d11 XIS DLL programs 

J gwxisl0.dll GroupWise XIS DLL program 

LJ agent.xml XIS agent configuration files 

Ll dbcopy.exe GroupWise Database Copy program 

3 help Subdirectory for GroupWise agent Web console help files 

c:\grpwise 


When you first install GroupWise Administration, the GroupWise agents are initially installed in 
platform-specific subdirectories in the agent directory. However, the agents cannot be run from 
this initial location. They must be installed on the servers where they will run. 


On a Windows server, the Group Wise agents can be installed in any directory you choose. The 
default is c: \grpwise. The agent icons are set up to include the full path to whatever directory 
you choose. 


gwenv1a.dIl file 


The gwenvla.dl11 file is the GroupWise Agent Engine, a program that is shared by both 
GroupWise agents. It provides the following services to the agents: 

+ Database management 

¢ File operations 

+ Message handling 

+ Thread management 

+ Semaphores (file/record locking) 


+ Date/time services 


The first agent started on a server automatically starts the GroupWise Agent Engine DLL. 
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gwpoa.exe file 


The gwpoa. exe file is the Post Office Agent program. You run this executable file to start the Post 
Office Agent. See “Starting the Windows GroupWise Agents” in “Installing GroupWise Agents” in 
the GroupWise 7 Installation Guide. 


gwmta.exe file 


The gwmta.exe file is the Message Transfer Agent program. You run this executable file to start 
the Message Transfer Agent. See “Starting the Windows GroupWise Agents” in “Installing 
GroupWise Agents” in the GroupWise 7 Installation Guide. 


gwsnmp.dll file 


The gwsnmp.d11 file provides interaction with the Windows SNMP Service, so that you can 
monitor the GroupWise agents using an SNMP monitoring program. 


gwwww1.dll file 


The gwwww1.d11 file provides parsing of MIME messages received from the Internet. 


strtupxx.poa file 
post_office.poa file 


The POA startup file contains startup switches for the POA. Switch settings placed in the POA 
startup file override comparable options set for the POA in ConsoleOne. The xx in the startup 
filename represents a two-letter language code. 


During installation, a customized version of the POA startup file, named post office.poa, is 
created. This customized version has the /home startup switch automatically set to the post office 
directory the POA will service. See “Using POA Startup Switches” in “Post Office Agent” in the 
GroupWise 7 Administration Guide. 


strtupxx.mta file 
domain.mta file 


The MTA startup file contains startup switches for the MTA. Switch settings placed in the MTA 
startup file override comparable options set for the MTA in ConsoleOne. The xx in the startup 
filename represents a two-letter language code. 


During installation, a customized version of the MTA startup file, named domain.MTA, is created. 
This customized version has the /home startup switch automatically set to the domain directory the 
MTA will service. See “Using MTA Startup Switches” in “Message Transfer Agent” in the 
GroupWise 7 Administration Guide. 


agentnxx.chm files 


The . chm files contain the online documentation for the agents. Online Help is available by 
clicking Help in the agent consoles on the server where the agents are running. In addition, dialog 
boxes have a Help button for context-sensitive Help. 


The first five characters of the filename are the agent name. The digit n is a version number. The last 
two characters xx are a language code. 
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agentnxx.dll files 


The agentnxx.d11 files contain all language-specific information for the agents. The digit n is a 
version number. The last two characters xx are a language code. 


x*10a.dll and gwxis10.dll files 


The x*10a.d11 and gwxis10.d11 programs provide XIS capability for the GroupWise agents, 
so that you can create XML documents to monitor and change the agents as needed. 


agent.xml files 


The agent .xml files are specialized agent configuration files for use in the XIS environment. 


dbcopy.exe file 


The dbcopy.exe file is the GroupWise Database Copy utility, which copies files from a live 
GroupWise post office or domain to a static location for backup. During the copy process, DBCopy 
prevents the files from being modified, using the same locking mechanism used by other GroupWise 
programs that access databases. This ensures that the backed-up versions are consistent with the 
originals even when large databases take a substantial amount of time to copy. For more 
information, see “GroupWise Database Copy Utility” in “Databases” in the GroupWise 7 
Administration Guide. 


help directory 


The help directory contains language-specific subdirectories for the help files available from the 
POA and MTA Web consoles. See “Using the POA Web Console” in “Post Office Agent” and 
“Using the MTA Web Console” in “Message Transfer Agent” in the GroupWise 7 Administration 
Guide. 


8.2 Internet Agent Installation 


¢ Section 8.2.1, “NetWare Installation Directory,” on page 114 
+ Section 8.2.2, “Linux Installation Directory,” on page 116 


+ Section 8.2.3, “Windows Installation Directory,” on page 119 


8.2.1 NetWare Installation Directory 


En sys: system NetWare Internet Agent installation directory 
LJ gwenn5.nlm GroupWise 7.x Agent Engine 
J gwia.nlm Internet Agent NLM program 
J gwia.cfg Internet Agent configuration file 
Ll gwianxx.fil Internet Agent language information file 
LJ gwia.ncf Internet Agent load file 
J)x*5.n1m XIS NLM programs 
LJ gwxisl2.nlm GroupWise XIS NLM programs 
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LJ gwia.xml XIS Internet Agent configuration file 


E help Subdirectory for GroupWise agent console help files 
See also Section 7.4, “Internet Agent Queue Directory,” on page 85. 


NetWare Internet Agent installation directory 


On a NetWare server, the GroupWise Internet Agent is typically installed in the sys: system 
directory. You can choose a different location during installation. 


gwenn5.nIm file 


The gwenn5.nlm file is the GroupWise 7.x Agent Engine, a program that is shared by all 
GroupWise agents. It provides the following services to the agents: 

+ Database management 

¢ File operations 

+ Message handling 

+ Thread management 

+ Semaphores (file/record locking) 


+ Date/time services 


The first agent loaded on a server automatically loads the GroupWise Agent Engine. 


gwia.nlm file 


The gwia .nlm file is the Internet Agent program. You load this NLM program to start the Internet 
Agent. See “Starting the Internet Agent” in “Installing the GroupWise Internet Agent” in the 
GroupWise 7 Installation Guide. 


gwia.cfg file 


The Internet Agent configuration file contains startup switches for the Internet Agent. Switch 
settings placed in the Internet Agent startup file override comparable options set for the Internet 
Agent in ConsoleOne. The startup file is named the same as the Internet Agent object in 
ConsoleOne. The default is gwia. 


During installation, a customized version of the Internet Agent startup file is created in 
sys: system. This customized version has the /home startup switch automatically set to the 
domain directory where the Internet Agent’s queue directories are located. See “Using Internet 
Agent Startup Switches” in “Internet Agent” in the GroupWise 7 Administration Guide. 


gwianxx.fil files 


This file contains all language-specific information for the Internet Agent. The digit n is a version 
number. The last two characters xx are a language code. 


gwia.ncf file 


The gwia.ncf file is the NetWare configuration file that automatically loads the Internet Agent 
whenever the server is restarted. A typical gwia . ncf file would look similar to the following: 
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load sys:\system\gwia @gwia.cfg 


x*5.nlm and gwxis12.nIm files 


The x*5.n1m and gwxis12.n1m programs provide XIS capability for the GroupWise agents, so 
that you can create XML documents to monitor and change the agents as needed. 


gwia.xml file 


The gwia. xml file is a specialized Internet Agent configuration file for use in the XIS 
environment. 


8.2.2 Linux Installation Directory 


w, opt/novell/groupwise/agents Linux agent installation directory 


de bin 
J gwia 
L gwia.xml 
LJ gwha 


DER 
J gwiaxxx.fil 
LJ libgwia.so 
Lj libgwia_ui.so 
O libgwha.so* 


E /ete/init.d 


J grpwise 


e FOS ck 


J S99grpwise 


Æ res.a 
LJ S99grpwise 


Subdirectory for GroupWise agent executables 
Internet Agent executable 

Internet Agent XIS configuration file 
GroupWise High Availability service executable 


Subdirectory for GroupWlse agent library files 
Internet Agent language information file 


Internet Agent shared library file 

Internet Agent user interface shared library file 
GroupWise High Availability service library files 
Supporting shared library files 


Subdirectory for icon images 


Subdirectory for agent shared files 
Internet Agent configuration file 


Subdirectory for agent console files 
Subdirectory agent console help files 


Subdirectory for agent Web console files 
Subdirectory for agent Web console help files 


Standard Linux location for application startup scripts 
Startup script for the Internet Agent 


Standard Linux location for run-level-3 symbolic links 
Symbolic link to the startup script for the Internet Agent 


Standard Linux location for run-level-5 symbolic links 
Symbolic link to the startup script for the Internet Agent 
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E fetc/opt Standard Linux location for application configuration files 
a novell/groupwise Subdirectory for GroupWise configuration files 
J gwha.conf GroupWise High Availability service configuration file 
w agents Subdirectory for GroupWise agents 
Ll uid. conf Agent configuration file for running as a non-root user 
Œ /var/109/ Standard Linux location for application log files 
w novell/groupwise Subdirectory for GroupWise agent log files 
E domain.gwia Domain-specific subdirectory for Internet Agent log files 
J mmddgwia.nnn Internet Agent log files 


See also Section 7.4, “Internet Agent Queue Directory,” on page 85. 


agents directory 


On a Linux server, the Internet Agent is always installed in subdirectories of /opt/novel1/ 
groupwise/agents. 


bin directory 
The bin directory holds GroupWise executable files. 
gwia file 


The gwia file is the Internet Agent executable. You run this executable file to start the Internet 
Agent. See “Starting the Internet Agent” in “Installing the GroupWise Internet Agent” in the 
GroupWise 7 Installation Guide. 


gwia.xml file 


The gwia. xml file is a specialized configuration file for use in the XIS environment. 


gwha file 


The gwha file is the GroupWise High Availability service executable. If the Internet Agent goes 
down for any reason, the High Availability service automatically restarts it. See “Enabling the High 
Availability Service for the Linux GroupWise Agents” in “Installing GroupWise Agents” in the 
GroupWise 7 Installation Guide. 


lib directory 
The 1ib directory holds GroupWise shared library files. 


gwiaxxx.fil files 


This file contains all language-specific information for the Internet Agent. The last two characters xx 
are a language code. 
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* so files 


These files are Linux shared library files that provide information to the Internet Agent executable. 


image directory 


The image directory has subdirectories for agent icons for both color and monochrome displays. 


share directory 


The share directory holds agent startup files and files that are used by the agent consoles and Web 
consoles. 


gwia.cfg 


The Internet Agent configuration file contains startup switches for the Internet Agent. Switch 
settings placed in the Internet Agent configuration file override comparable configuration options 
set for the Internet Agent in ConsoleOne. The startup file is named the same as the Internet Agent 
object in ConsoleOne. The default is gwia. 


During installation, the Internet Agent startup file is created in the share directory with the --home 
startup switch automatically set to the domain directory where the Internet Agent queue directory is 
located. See “Using Internet Agent Startup Switches” in “Internet Agent” in the GroupWise 7 
Administration Guide. 


agtcon directory 


The agtcon directory holds subdirectories and files used by the agent consoles, such as help files. 


webcon directory 


The webcon directory holds subdirectories and files used by the agent Web consoles, such as help 
files. 


letc/init.d directory 
The /etc/init.d directory is the standard location for Linux startup scripts. 
grpwise file 


The grpwise script is created automatically during installation. You can use the script to start, 
restart, stop, and display status information about the Internet Agent. For more information about 
starting the Internet Agent, see “Starting the Internet Agent” in “Installing the GroupWise Internet 
Agent” in the GroupWise 7 Installation Guide. 


rc3.d directory 


The rc3.d directory holds symbolic links to scripts that you want your Linux server to run when it 
is booted to runlevel 3 (multi-user; boots to a text mode login prompt without the X Window 
System). The symbolic link to the grpwise script is S99grpwise. It is created if you choose 
during installation to have the Internet Agent start automatically when the server boots. 
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rc5.d directory 


The rc5.d directory holds symbolic links to scripts that you want your Linux server to run when it 
is booted to runlevel 5 (multi-user; boots to the X Window System login dialog box). The symbolic 
link to the grpwise script is S99grpwise. It is created if you choose during installation to have 
the Internet Agent start automatically when the server boots. 


letc/opt/novell/groupwise directory 


The /etc/opt directory is the standard location of application configuration files on Linux. Files 
that configure how the GroupWise Internet Agent interacts with Linux are stored in the novel 1/ 
groupwise subdirectory. 


gwha.conf file 


The gwha. conf file is the GroupWise High Availability service configuration file. It is created 
automatically during installation and provides the information necessary for the High Availability 
service to restart the Internet Agent if it goes down unexpectedly. See “Enabling the High 
Availability Service for the Linux GroupWise Agents” in “Installing GroupWise Agents” in the 
GroupWise 7 Installation Guide. 


uid.conf file 


The uid.conf file configures the Internet Agent to run as a non-root user. See “Running the Linux 
GroupWise Agents as a Non-root User” in “Installing GroupWise Agents” in the GroupWise 7 
Installation Guide. 


Ivar/log/novell/groupwise directory 


The /var/ log directory is the standard location for log files on Linux. All GroupWise agent log 
files are created in the nove11/groupwise subdirectory. 


domain.gwia directory 
The domain.gwia directory is a domain-specific location for Internet Agent log files. 


Within the domain .gwia directory, the Internet Agent creates log files (mmddgwia. nnn) to 
inform you of its processing and any problems it encounters. For more information about log files, 
see “Using Internet Agent Log Files” in “Internet Agent” in the GroupWise 7 Administration Guide. 


The first two digits of the filename represent the month; the next two digits represent the day of the 
month. The three-digit extension is a sequence number for multiple log files created on the same 
day. For example, 0518gwia. 002 is the second Internet Agent log file created on May 18. 


8.2.3 Windows Installation Directory 


Me o: \grpwise\gwia Windows Internet Agent installation directory 
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LJ gwenvla.dll GroupWise Agent Engine 


LJ gwia.exe Internet Agent program 

J gwia.cfg Internet Agent configuration file 

J gwianxx.chm Internet Agent online help file 

J gwianxx.dll Internet Agent language information file 
J gwwww1.dll Customized DLL program for MIME 

LÌ x*10a.d11 XIS DLL programs 

J gwxisl0.dll GroupWise XIS DLL program 

LJ gwia.xml XIS agent configuration file 


See also Section 7.4, “Internet Agent Queue Directory,” on page 85. 


c:\grpwise\gwia 


On a Windows server, the Internet Agent can be installed in any directory you choose. The default 
location is c: \grpwise\gwia. The Internet Agent icon is set up to include the full path to 
whatever directory you choose. 


gwenv1a.dIl file 


The gwenvla.dl11 file is the GroupWise Agent Engine, a program that is shared by both 
GroupWise agents. It provides the following services to the agents: 


+ Database management 

¢ File operations 

+ Message handling 

+ Thread management 

+ Semaphores (file/record locking) 


+ Date/time services 


The first agent started on a server automatically starts the GroupWise Agent Engine DLL. 


gwia.exe file 


The gwia . exe file is the Internet Agent program. You run this executable file to start the Internet 
Agent. See “Starting the Internet Agent” in “Installing the GroupWise Internet Agent” in the 
GroupWise 7 Installation Guide. 


gwia.cfg file 


On Windows, the gwia .cfg file in the installation directory is simply a pointer to the gvia.cfg 
file under the domain directory where the actual Internet Agent configuration file is located. 


gwianxx.chm file 


The . chm files contain the online documentation for the Internet Agent. Online help is available by 
clicking Help in the Internet Agent console on the server where the agent is running. In addition, 
dialog boxes have a Help button for context-sensitive Help. 


The digit n is a version number. The last two characters xx are a language code. 
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gwianxx.dll files 


The gwianxx.d11 files contain all language-specific information for the Internet Agent. The digit 
n is a version number. The last two characters xx are a language code. 


gwwww1.dll file 


The gwwww1 .d11 file provides parsing of MIME messages received from the Internet. 


x*10a.dll and gwxis10.dll files 


The x*10a.d11l and gwxis10.dl11 programs provide XIS capability for the Group Wise agents, 
so that you can create XML documents to monitor and change the agents as needed. 


gwia.xml file 


The gwia. xml file is a specialized agent configuration file for use in the XIS environment. 


8.3 WebAccess Agent Installation 


¢ Section 8.3.1, “NetWare Installation Directory,” on page 121 


¢ Section 8.3.2, “Linux Installation Directory,” on page 123 


+ 


Section 8.3.3, “Windows Installation Directory,” on page 129 


+ 


Section 8.3.4, “Document Viewer Agent Working Directory,” on page 131 


8.3.1 NetWare Installation Directory 


= sys:\system NetWare WebAccess Agent installation directory 


J gwenn5.nlm 
LJ gwinter.nlm 
J gwdva.nlm 
L strtweb.ncf 
| stopweb.ncf 


LJ webac70a.waa 
| gwdva.dva 


Ll "3. nm 
LJ gwxisl2.nlm 
J gwinter.xml 
T cache 
= template\xx 
J webacc.tpt 
Ll publish.tpt 


= gwdva.dir 
E help 


GroupWise 7.x Agent Engine 
WebAccess Agent program 
Document Viewer Agent program 
WebAccess Agent load file 
WebAccess Agent unload file 


WebAccess Agent startup file 
Document Viewer Agent startup file 


XIS NLM programs 
GroupWise XIS NLM program 
WebAccess Agent XIS configuration file 


Subdirectory for WebAccess template file storage 
Subdirectory for HTML template files 

WebAccess template files 

WebPublisher template files 


Document Viewer Agent working directory 


Subdirectory for GroupWise agent console help files 


Agent Installation Directories 121 


Additional WebAccess files are integrated into your Web server to support the WebAccess client 
and the WebAccess Agent Web console. See Section 8.5, “Apache/Tomcat Installation,” on 
page 137. See also Section 7.5, “WebAccess Agent Queue Directory,” on page 92. 


NetWare WebAccess Agent installation directory 

On a NetWare server, the GroupWise WebAccess Agent is typically installed in the 
sys:\system directory. You can choose a different location during installation. 
gwenn5.nIm file 


The gwenn5.nlm file is the GroupWise 7.x Agent Engine, a program that is shared by all 
GroupWise agents. It provides the following services to the agents: 


+ Database management 

+ File operations 

+ Message handling 

+ Thread management 

+ Semaphores (file/record locking) 


+ Date/time services 


The first agent loaded on a server automatically loads the GroupWise Agent Engine. 


gwinter.nlm file 


The gwinter .nl1m file is the WebAccess Agent program. 


gwdva.nim file 


The gwdva . n1m file is the Document Viewer Agent program. 


strtweb.ncf file 


The strtweb.ncf file is the NetWare configuration file that automatically loads the WebAccess 
Agent whenever the server is restarted. A typical strtweb.ncf file would look similar to the 
following: 


load sys:\system\gwinter @webac70a.waa 


It includes the WebAccess Agent startup file in the load command. For more information, see 
“Starting GroupWise WebAccess” in “Installing GroupWise WebAccess” in the GroupWise 7 
Installation Guide. 


stopweb.ncf 


The stopweb.ncf file is the NetWare configuration file that unloads the WebAccess Agent. A 
typical stopweb.ncf file would look similar to the following: 
unload gwinter 


webac70a.waa file 


The WebAccess Agent startup file contains startup switches for the WebAccess Agent. Switch 
settings placed in the WebAccess Agent startup file override comparable options set for the 
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WebAccess Agent in ConsoleOne. The startup file is named the same as the WebAccess Agent 
object in ConsoleOne. The default is webac70a. 


During installation, a customized version of the WebAccess Agent startup file is created. This 
customized version has the /home startup switch automatically set to the domain directory where the 
WebAccess Agent’s queue directories are located. See “Using WebAccess Startup Switches” in 
“WebAccess” in the GroupWise 7 Administration Guide. 


gwdva.dva file 


The gwdva . dva file is the Document Viewer Agent startup file. The Viewer Agent is currently 
configured completely by startup switches. For more information, see “Document Viewer Agent 
Startup Switches”. 


x*5.nlm and gwxis12.nIm files 


The x*5.n1m and gwxis12.n1m programs provide XIS capability for the GroupWise agents, so 
that you can create XML documents to monitor and change the agents as needed. 


gwinter.xml file 


The gwinter. xml file is a specialized WebAccess Agent configuration file for use in the XIS 
environment. 


cache\template\xx directory 


The cache\template)\ xx directory holds language-specific HTML template files that the 
WebAccess Agent passes to the Document Viewer Agent for viewing documents in documents in 
WebAccess and WebPublisher. The xx is a two-letter language code. 


gwdva.dir directory 


See Section 8.3.4, “Document Viewer Agent Working Directory,” on page 131. 


help directory 


The help directory holds help files and images used by the WebAccess Agent Web console. See 
“Using the WebAccess Agent Web Console” in “WebAccess” in the GroupWise 7 Administration 
Guide. 


8.3.2 Linux Installation Directory 


= /opt/novell/groupwise Novell GroupWise installation directory 


Ta agents Linux agent installation directory 
3 bin Subdirectory for GroupWise agent executables 
J gwinter WebAccess Agent executable 
L gwinter.xml WebAccess Agent XIS configuration file 
E webac70axx.waa Boilerplate WebAccess startup file 
= template Subdirectory for HTML template files 
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L] gwdva 


gwdva.dir 


LJ webac70a.waa 


gwdva.dva 


E webcon 
E help 


E webaccess 


J webacc.cfg 
L commgr.cfig 
J spellehk. cig 
JJ L1dap. ec Ey 

W default 

= logs 

W users 


= webpublisher 


J webpub.cfg 
LJ commgr.cfg 
W default 


=] Logs 


BY /etc/init.a 
J grpwise 


= KOs. 


J S99grpwise 


rend 
J S99grpwise 


Œ /var/10g/ 
aa 


z domain.webac70a 


z OOO. pee 


J mmddgwia.nnn 


=] gwdva 


LJ mmdddva.nnn 


ovell/groupwise 


Document Viewer Agent executable 
Document Viewer Agent working directory 


Subdirectory for GroupWise agent library files 
Supporting shared library files 


Subdirectory for icon images 


Subdirectory for agent shared files 
WebAccess Agent startup file 
Document Viewer Agent startup file 


Subdirectory for agent Web console files 
Subdirectory for agent Web console help files 


Subdirectory for WebAccess Application files 


WebAccess Application configuration file 
Communications Manager configuration file 

Novell Speller Application configuration file 

LDAP service provider configuration file 

Subdirectory for boilerplate configuration files 
Subdirectory for WebAccess Application log files 
Subdirectory for users’ WebAccess session information 


Subdirectory for WebAccess Application files 


WebPublisher Application configuration file 
Communications Manager configuration file 
Subdirectory for boilerplate configuration files 
Subdirectory for WebPublisher Application log files 


Standard Linux location for application startup scripts 
Startup script for the WebAccess Agent 


Standard Linux location for run-level-3 symbolic links 
Symbolic link to the startup script for the WebAccess Agent 


Standard Linux location for run-level-5 symbolic links 
Symbolic link to the startup script for the WebAccess Agent 


Standard Linux location for application log files 
Subdirectory for GroupWise agent log files 


Domain-specific subdirectory for WebAccess Agent log files 
Processing directory for log files 
WebAccess Agent log files 


Subdirectory for Viewer Agent log files 


Viewer Agent log files 
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Additional WebAccess files are integrated into your Web server to support the WebAccess client 
and the WebAccess Agent Web console. See Section 8.5, “Apache/Tomcat Installation,” on 
page 137. See also Section 7.5, “WebAccess Agent Queue Directory,” on page 92. 


agents directory 


On a Linux server, the WebAccess Agent is always installed in subdirectories of /opt/novell/ 
groupwise/agents. 


bin directory 
The bin directory holds GroupWise executable files. 
gwinter file 


The gwinter file is the WebAccess Agent executable. You run this executable file to start the 
WebAccess Agent. See “Linux: Setting Up GroupWise WebAccess” in “Installing GroupWise 
WebAccess” in the GroupWise 7 Installation Guide. 


gwinter.xml file 
The gwinter.xml file is a specialized configuration file for use in the XIS environment. 
webac70axx.waa file 


The webac70axx.waa file is the boilerplate file from which a domain-specific webac70a.waa 
file is created in the share directory. The webac70a represents the name of the WebAccess Agent 
object in eDirectory. The xx represents a two-letter language code. 


template\xx directory 


The template \ xx directory holds language-specific HTML template files that the WebAccess 
Agent passes to the Document Viewer Agent for viewing documents in WebAccess and 
WebPublisher. The xx is a two-letter language code. 


gwdva file 


The gwdva file is the Document Viewer Agent executable. The WebAccess A gent starts and stops 
the Viewer Agent automatically whenever 1t starts and stops. 


gwdva.dir directory 

See Section 8.3.4, “Document Viewer Agent Working Directory,” on page 131. 
lib directory 

The 1 ib directory holds GroupWise shared library files. 


* so files 


The * . so files are Linux shared library files that provide information to the WebAccess Agent 
executable. 
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image directory 


The image directory has subdirectories for agent icons for both color and monochrome displays. 


share directory 


The share directory holds agent startup files and files that are used by the agent consoles and Web 
consoles. 


webac70a.waa file 


The WebAccess Agent startup file contains startup switches for the WebAccess Agent. Switch 
settings placed in the WebAccess Agent startup file override comparable options set for the 
WebAccess Agent in ConsoleOne. The startup file is named the same as the WebAccess Agent 
object in ConsoleOne. The default is webac70a. 


During installation, a customized version of the WebAccess Agent startup file is created. This 
customized version has the /home startup switch automatically set to the domain directory where the 
WebAccess Agent's queue directories are located. See “Using WebAccess Startup Switches” in 
“WebAccess” in the GroupWise 7 Administration Guide. 


gwdva.dva file 


The gwdva . dva file is the Document Viewer Agent startup file. The Viewer Agent is currently 
configured completely by startup switches. For more information, see “Document Viewer Agent 
Startup Switches”. 


webcon directory 


The webcon directory holds subdirectories and files used by the agent Web consoles, such as help 
files. 


webaccess directory 


The webaccess directory holds files used by the WebAccess Application. 


webacc.cfg file 


The webacc.cfg file holds the same configuration information that is stored on the WebAccess 
Application object (named GroupWiseWebAccess) in eDirectory. For more information, see 
“Configuring the WebAccess Application” in “WebAccess” in the GroupWise 7 Administration 
Guide. 


commgr.cfg file 


The commgr . cfg file holds the same configuration information that is stored on the GroupWise 
Provider object (named GroupWiseProvider) in eDirectory, including the IP address and encryption 
key for the WebAccess Agent. This information enables the WebAccess Application to 
communicate with the WebAccess Agent. For more information, see “Configuring the GroupWise 
Service Provider” in “WebAccess” in the GroupWise 7 Administration Guide. 


A copy of the commgr . cfg file is automatically maintained in the WebAccess Agent queue 
directory (domain/wpgate/webac70a). 
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spellchk.cfg file 


The spellchk.cfg file holds the same configuration information that is stored on the Novell 
Speller Application object (named NovellSpeller) in eDirectory. For more information, see 
“Configuring the Novell Speller Application” in “WebAccess” in the GroupWise 7 Administration 
Guide. 


Idap.cfg file 


The 1dap. cfg file holds the same configuration information that is stored on the LDAP Provider 
object (named LDAPProvider) in eDirectory. For more information, see “Configuring the LDAP 
Service Provider” in “WebAccess” in the GroupWise 7 Administration Guide. 


default directory 


The default directory holds boilerplate versions of the various .cfg files. 


logs directory 


The Logs subdirectory holds WebAccess Application log files. For more information, see 
“Controlling WebAccess Application Logging” in “WebAccess” in the GroupWise 7 
Administration Guide. 


users directory 


The users subdirectory holds session files for WebAccess users. If WebAccess times out after a 
period of user inactivity, the user’s session information is saved. When the user logs back in, the 
session information is retrieved so that the user can continue working without loss of data. Also, 
users’ message text is saved during each session, so that if the WebAccess Application is restarted 
or goes down, users do not lose the message text they were composing at the time. Session files are 
deleted when users log back in. 


webpublisher directory 


The webpublisher directory holds files used by the WebPublisher Application. 


webpub.cfg 


The webpub.cfg file holds the same configuration information that is stored on the WebPublisher 
Application object (named Group WiseWebPublisher) in eDirectory. For more information, see 
“Configuring the WebPublisher Application” in “WebAccess” in the GroupWise 7 Administration 
Guide. 


commgr.cfg file 


The commgr . cfg file holds the same configuration information that is stored on the Group Wise 
Provider object (named GroupWiseProvider) in eDirectory, including the IP address, port number, 
number of threads, and encryption key for the WebAccess Agent. This information enables the 
WebAccess Application to communicate with the WebAccess Agent. For more information, see 
“Configuring the GroupWise Service Provider” in “WebAccess” in the GroupWise 7 Administration 
Guide. 


A copy of the commgr . c fg file is automatically maintained in the WebAccess Agent queue 
directory (domain/wpgate/webac70a). 
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default directory 


The default directory holds boilerplate versions of the webpub.cfg and commgr . cfg files. 


logs directory 


The logs subdirectory holds WebPublisher Application log files. For more information, see 
“Controlling WebAccess Application Logging” in “WebAccess” in the GroupWise 7 
Administration Guide. 


letc/init.d directory 


The /etc/init.d directory is the standard location for Linux startup scripts. 
grpwise file 


The grpwi se script is created automatically during installation. You can use the script to start, 
restart, stop, and display status information about the WebAccess Agent. For more information 
about starting the WebAccess Agent, see “Linux: Setting Up GroupWise WebAccess” in “Installing 
GroupWise WebAccess” in the GroupWise 7 Installation Guide. 


rc3.d directory 


The rc3. d directory holds symbolic links to scripts that you want your Linux server to run when it 
1s booted to runlevel 3 (multi-user; boots to a text mode login prompt without the X Window 
System). The symbolic link to the grpwise script is S99grpwise. It is created if you choose 
during installation to have the WebAccess Agent start automatically when the server boots. 


rc5.d directory 


The rc5.d directory holds symbolic links to scripts that you want your Linux server to run when it 
is booted to runlevel 5 (multi-user; boots to the X Window System login dialog box). The symbolic 
link to the grpwise script is S99grpwise. It is created if you choose during installation to have 
the WebAccess Agent start automatically when the server boots. 


Ivar/log/novell/groupwise directory 


The /var/ log directory is the standard location for log files on Linux. All GroupWise agent log 
files are created in the novell/groupwise subdirectory. 


domain.webac70a directory 
The domain.webac70a directory is a domain-specific location for WebAccess A gent log files. 


000.pre directory 

Within the 000 . prc directory, the WebAccess Agent creates log files (mmddweb . nnn) to inform 
you of its processing and any problems it encounters. For more information about log files, see 
“Controlling WebAccess Agent Logging” in “WebAccess” in the GroupWise 7 Administration 
Guide. 


The first two digits of the filename represent the month; the next two digits represent the day of the 
month. The three-digit extension is a sequence number for multiple log files created on the same 
day. For example, 0518web.002 is the second WebAccess Agent log file created on May 18. 
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gwdva directory 


The gwdva directory stores Viewer Agent log files. The first two digits of the filename represent 
the month; the next two digits represent the day of the month. The three-digit extension is a 
sequence number for multiple log files created on the same day. For example, 051 8web.002 is the 
second Viewer Agent log file created on May 18. 


8.3.3 Windows Installation Directory 


H c:\webace Windows WebAccess Agent installation directory 
LJ gwenvla.dll GroupWise Agent Engine 
J gwinter.exe WebAccess Agent program 
LÌ strtweb.bat WebAccess Agent batch file 
Ll webac70a.waa WebAccess Agent startup file 
J gwdva.exe Document Viewer Agent program 
LJ gwdva.dva Document Viewer Agent startup file 
w gwdva.dir Document Viewer Agent working directory 
L gwwanxx.dll WebAccess Agent language information file 
L gwwasnmp.dll Customized DLL program for SNMP 
J gwwww1.dll Customized DLL program for MIME 
L x*10a.d11 XIS DLL programs 
J gwxisl0.dll GroupWise XIS DLL program 
| gwinter.xml WebAccess Agent XIS configuration file 
E cache\template\xx Subdirectory for HTML template files 
J webacc.tpt WebAccess template files 
L publish.tpt WebPublisher template files 
E help Subdirectory for GroupWise agent console help files 


Additional WebAccess files are integrated into your Web server to support the WebAccess client 
and the WebAccess Agent Web console. See Section 8.5, “Apache/Tomcat Installation,” on 
page 137. See also Section 7.5, “WebAccess Agent Queue Directory,” on page 92. 


c:\webacc 


On a Windows server, the WebAccess Agent can be installed in any directory you choose. The 
default location is c: \webacc. The WebAccess Agent desktop icon is set up to include the full 
path to whatever directory you choose. 


gwenv1a.dll file 


The gwenvla.d11 file is the GroupWise Agent Engine, a program that is shared by all 
Group Wise agents. It provides the following services to the agents: 


+ Database management 
+ File operations 


+ Message handling 
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+ Thread management 
+ Semaphores (file/record locking) 


+ Date/time services 


The first agent started on a server automatically starts the GroupWise Agent Engine DLL. 


gwinter.exe file 


The gwinter.exe file is the WebAccess Agent program. 


strtweb.bat file 


The strtweb.bat file is used to start the WebAccess Agent. The batch file specifies the 
WebAccess startup file. A typical strtweb.bat file includes the following: 


title Novell GroupWise WebAccess 
@echo off 

cls 

gwinter.exe @webac70a.waa 


You run this batch file to start the WebAccess Agent. See “Starting Group Wise WebAccess” in 
“Installing GroupWise WebAccess” in the GroupWise 7 Installation Guide. 


webac70a.waa file 


The WebAccess Agent startup file contains startup switches for the WebAccess Agent. Switch 
settings placed in the WebAccess Agent startup file override comparable configuration options set 
for the WebAccess Agent in ConsoleOne. The startup file is named the same as the WebAccess 
Agent object in eDirectory. The default is webac70a. 


During installation, the WebAccess Agent startup file is created with the /home startup switch 
automatically set to the domain directory where the WebAccess Agent queue directory 
(domain\wpgate\webac 70a) is located. See “Using WebAccess Startup Switches” in 
“WebAccess” in the GroupWise 7 Administration Guide. 


gwdva.exe file 


The gwdva.exe file is the Document Viewer Agent program. The WebAccess Agent 
automatically starts and stops the Viewer Agent whenever the WebAccess Agent starts and stops. 


gwdva.dva file 


The gwdva . dva file is the Document Viewer Agent startup file. The Viewer Agent is currently 
configured completely by startup switches. See “Document Viewer Agent Startup Switches”. 


gwdva.dir directory 


See Section 8.3.4, “Document Viewer Agent Working Directory,” on page 131. 


gwwanxx.dll files 


The gwwanxx.d11 files contain all language-specific information for the WebAccess Agent. The 
digit n is a version number. The last two characters xx are a language code. 


130 GroupWise 7 Troubleshooting 3: Message Flow and Directory Structure 


gwwasnmp.dll file 


The gwwasnmp.d11 file provides interaction with the Windows SNMP Service, so that you can 
monitor the WebAccess Agent using an SNMP monitoring program. This file is not installed unless 
you enable SNMP during installation. It cannot be installed if the SNMP Service is not installed on 
the Windows server. 


gwwww1.dil file 


The gwwww1 .d11 file provides parsing of MIME messages received from the Internet. 


x*10a.dll and gwxis10.dll files 


The x*10a.d11 and gwxis10.d11 programs provide XIS capability for the Group Wise agents, 
so that you can create XML documents to monitor and change the agents as needed. 


gwinter.xml file 


The gwia. xml file is a specialized agent configuration file for use in the XIS environment. 


cache\template\xx directory 


The cache\template\ xx directory holds language-specific HTML template files that the 
WebAccess Agent passes to the Document Viewer Agent for viewing documents in WebAccess and 
WebPublisher. The xx is a two-letter language code. 


help directory 


The help directory holds help files and images used by the WebAccess Agent Web console. See 
“Using the WebAccess Agent Web Console” in “WebAccess” in the GroupWise 7 Administration 
Guide. 


8.3.4 Document Viewer Agent Working Directory 


The Document Viewer Agent creates its working directory as a subdirectory of its installation 
directory. The default location varies by platform: 


NetWare: sys:\system\gwdva.dir 
Linux: /opt/novell/groupwise/agents/bin/gwdva.dir 
Windows: c:\webacc\gwdva.dir 
E] gwdva.dir Document Viewer Agent working directory 
3 cache Subdirectory for caching converted documents for repeated display 
z 000 Subdirectory for converted GroupWise library documents 
w tran Subdirectory for converted attachment documents 
z problem Subdirectory for information about documents that failed conversion 
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ig hold Subdirectory for quarantined documents that failed HTML conversion 


m log Subdirectory for Document Viewer Agent log files 
= temp Subdirectory for the temporary files using during HTML conversion 
w template (not currently used) 


gwdva.dir directory 


The gwdva .dir directory is the working directory for the Document Viewer Agent. 


cache directory 


The cache directory contains subdirectories for managing the documents that the Viewer Agent 
has already converted. See “Document Cache” in “WebAccess” in the Group Wise 7 Administration 
Guide. 


000 directory 


The 000 directory holds GroupWise library documents that have been converted to HTML. 
Because these documents belong to a GroupWise library, they are retained for a longer period of 
time. If the documents in the 000 directory exceed the established maximum cache size, a new 
directory, 001, is created. Additional library cache directories are created as needed. 


tran directory 


The t ran directory holds attachment documents that have been converted to HTML. Attached 
documents are more transitory than GroupWise library documents and are retained for a shorter 
period of time. 


problem directory 


The problem directory stores information about documents that have failed conversion. This 
prevents the Viewer Agent from needlessly attempting to convert the same failed documents. 


hold directory 


The hold directory is the document quarantine directory. Here the Viewer Agent places documents 
that have failed HTML conversion. You can configure the Viewer Agent to notify an administrator 
when a document fails conversion. See “Document Quarantine” in “WebAccess” in the GroupWise 
7 Administration Guide 


log directory 


The log directory stores log files produced by the Viewer Agent. See “Agent Log Files” in 
“WebAccess” in the GroupWise 7 Administration Guide. 





NOTE: On Linux, Viewer Agent log files are stored in the typical location for log files on Linux (/ 
var/log/novell/groupwise/gwdva), rather than under the gwdva . di r directory. 





temp directory 


The temp directory is used for the temporary files created during HTML conversion. See 
“Document Conversion” in “WebAccess” in the GroupWise 7 Administration Guide. 
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8.4 Monitor Agent Installation 


+ Section 8.4.1, “Linux Installation Directory,” on page 133 


+ Section 8.4.2, “Windows Installation Directory,” on page 135 


8.4.1 Linux Installation Directory 


w /opt/novell/groupwise 


an 


| agents 


L share 


J moña tot, 311 
= gwmonitor 


J gwmonitor.cfg 
H default 


a logs 
= users 


BH /etc/init.d 
J grpwise-ma 
a LEIA 
= S99grpwise-ma 


E ros.a 
J S99grpwise-ma 


W /var/1og/ 
= novell/groupwise 


a gwmon 


Ll mmddmon.nnn 
Ll mmddhist.nnn 


EN acct 


agents directory 


GroupWise installation directory 
Linux agent installation directory 


Subdirectory for GroupWise agent executables 
Monitor Agent executable 


Subdirectory for GroupWise agent library files 
Supporting shared library files 


Subdirectory for agent shared files 
Monitor Agent configuration file 


Subdirectory for Monitor Application files 


Monitor Application configuration file 
Subdirectory for boilerplate configuration files 
Subdirectory for Monitor Application log files 
Directory for Monitor users' session files 


Standard Linux location for application startup scripts 
Startup script for the Monitor Agent 


Standard Linux location for run-level-3 symbolic links 
Symbolic link to the startup script for the Monitor Agent 


Standard Linux location for run-level-5 symbolic links 
Symbolic link to the startup script for the Monitor Agent 


Standard Linux location for application log files 
Subdirectory for GroupWise agent log files 


Subdirectory for Monitor Agent log files 
Monitor Agent event log files 
Monitor Agent history log files 


Subdirectory for Monitor Agent accounting files 


On a Linux server, the Monitor Agent is always installed in subdirectories of /opt/nove11/ 


groupwise/agents. 
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bin directory 
The bin directory holds GroupWise executable files. 
gwmon file 


The gwmon file is the Monitor Agent executable. You run this executable file to start the Monitor 
Agent. See “Starting the Linux Monitor Agent as a Daemon” in “Installing GroupWise Monitor” in 
the GroupWise 7 Installation Guide. 


lib directory 
The 1ib directory holds GroupWise shared library files. 
*.so files 


These files are Linux shared library files that provide information to the Monitor Agent executable. 


share directory 


The share directory holds agent startup files and files that are used by the agent consoles and Web 
consoles. 


monitor.xml file 


The monitor .xml file is a specialized configuration file for use in the XIS environment. 


gwmonitor directory 
The gwmonitor directory holds files used by the Monitor Application. 
gwmonitor.cfg file 


The gwmonitor.cfg file holds the same configuration information that is stored on the Monitor 
Application object (named Group WiseMonitor) in eDirectory. For more information, see 
“Configuring the Monitor Application” in “Monitor” in the GroupWise 7 Administration Guide. 


default directory 


The default directory holds boilerplate versions of the gwmonitor.cfg file and the monitor.xml 
file. 


logs directory 


The Logs subdirectory holds Monitor Application log files. For more information, see “Modifying 
Monitor Application Log Settings” in “Monitor” in the GroupWise 7 Administration Guide. 


users directory 


The users subdirectory holds session files for Monitor users. 


letc/init.d directory 


The /etc/init.d directory is the standard location for Linux startup scripts. 
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grpwise-ma file 


The grpwise-ma script is created automatically during installation. You can use the script to start, 
restart, stop, and display status information about the Monitor Agent. For more information about 
starting the Monitor Agent, see “Starting the Linux Monitor Agent as a Daemon” in “Installing 
GroupWise Monitor” in the GroupWise 7 Installation Guide. 


rc3.d directory 


The rc3.d directory holds symbolic links to scripts that you want your Linux server to run when it 
is booted to runlevel 3 (multi-user; boots to a text mode login prompt without the X Window 
System). The symbolic link to the grpwise-ma script is S99grpwise-ma. It is created if you 
choose during installation to have the Monitor Agent start automatically when the server boots. 


rc5.d directory 


The rc5.d directory holds symbolic links to scripts that you want your Linux server to run when it 
is booted to runlevel 5 (multi-user; boots to the X Window System login dialog box). The symbolic 
link to the grpwise-ma script is S99grpwise-ma. It is created if you choose during installation 
to have the Monitor Agent start automatically when the server boots. 


Ivar/log/novell/groupwise directory 


The /var/ log directory is the standard location for log files on Linux. All GroupWise agent log 
files are created in the novel l/groupwise subdirectory. 


gwmon directory 


Within the gwmon directory, the Monitor Agent creates two different types of log files. The 
mmddmon.nnn log files inform you of its processing and any problems it encounters. The 
mmddhist.nnn log files record dumps of all MIB values gathered during each poll cycle. For 
more information about log files, see “Configuring Monitor Agent Log Settings” in “Monitor” in the 
GroupWise 7 Administration Guide. 


The first two digits of the filename represent the month; the next two digits represent the day of the 
month. The three-digit extension is a sequence number for multiple log files created on the same 
day. For example, 0518mon.002 is the second Monitor Agent log file created on May 18. 


gwmon/acct directory 


Within the gwmon directory, the Monitor Agent creates an acct subdirectory for storing 
accounting files received from the Internet Agent and GroupWise gateways. For more information, 
see “Receiving the Accounting Files” in “Monitor” in the GroupWise 7 Administration Guide. 


8.4.2 Windows Installation Directory 


E c:\gwmon Windows Monitor Agent installation directory 
LJ gwenvla.dll GroupWise Agent Engine 
El gwmon. exe Monitor Agent program 
LÌ monitor.xml Monitor Agent configuration file 
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L gwmonxx.dl1 Monitor Agent language information file 


J gwsnmp.dll Customized DLL program for SNMP 

LÌ x*10a.d11 XIS DLL programs 

J gwxisl0.dll GroupWise XIS DLL program 

LJ gwmon. xml Monitor Agent XIS configuration file 

Es monwork Monitor Agent working directory 

3 acct Monitor Agent directory for accounting files 


Additional Monitor files are integrated into your Web server to support the Monitor Web console. 
For an example, see Section 8.5, “Apache/Tomcat Installation,” on page 137. 


c:\gwmon directory 


On a Windows server, the Monitor Agent can be installed in any directory you choose. The default 
location is c : \gwmon. The Monitor Agent desktop icon is set up to include the full path to 
whatever directory you choose. 


gwenv1a.dll file 


The gwenvla.d11 file is the GroupWise Agent Engine, a program that is shared by all 
GroupWise agents. It provides the following services to the agents: 

+ Database management 

+ File operations 

+ Message handling 

+ Thread management 

+ Semaphores (file/record locking) 


+ Date/time services 


The first agent started on a server automatically starts the GroupWise Agent Engine DLL. 


gwmon.exe file 


The gwmon . exe file is the Monitor Agent program. You run this executable file to start the 
Monitor Agent. See “Windows: Setting Up GroupWise Monitor” in “Installing GroupWise 
Monitor” in the GroupWise 7 Installation Guide. 


monitor.xml 


The monitor .xml file stores the Monitor Agent configuration information that you establish in 
the Monitor Agent console, as described in “Configuring the Monitor Agent” in “Monitor” in the 
GroupWise 7 Administration Guide. 


gwmonxx.dll files 


The gwmonxx.d11 files contain all language-specific information for the WebAccess Agent. The 
last two characters xx are a language code. 
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gwsnmp.dll file 


The gwsnmp.d11 file provides interaction with the Windows SNMP Service, so that the Monitor 
Agent can throw SNMP traps. See “Configuring SNMP Trap Notification for Agent Problems” in 
“Monitor” in the GroupWise 7 Administration Guide. 


x*10a.dll and gwxis10.dll files 


The x*10a.d11l andgwxisl10.dl1l programs provide XIS capability for the GroupWise agents, 
so that you can create XML documents to monitor and change the agents as needed. 


gwmon.xml file 


The gwmon . xml file is a specialized agent configuration file for use in the XIS environment. 


monwork directory 


The monwork directory is used for temporary files used in calculating system performance, as 
described in “Measuring Agent Performance” in “Monitor” in the GroupWise 7 Administration 
Guide 


acct directory 


The acct directory is used for storing accounting files received from the Internet Agent and 
Group Wise gateways, as described in “Receiving the Accounting Files” in “Monitor” in the 
GroupWise 7 Administration Guide. 


8.5 Apache/Tomcat Installation 


WebAccess, WebPublisher, and Monitor rely on the presence of a Web server in order to fulfil their 
functions. A number of Web servers are supported. See “GroupWise System Requirements” in 
“Installing a Basic GroupWise System” in the GroupWise 7 Installation Guide. In this section, the 
Apache Web server and the Tomcat Servlet Engine used to illustrate how GroupWise integrates 
with your Web server. 


+ Section 8.5.1, “NetWare Installation Directory,” on page 137 


¢ Section 8.5.2, “Linux Installation Directory,” on page 142 


8.5.1 NetWare Installation Directory 


= sys:\apache2 Apache installation directory 
i bin Standard Apache directory 
= cgi-bin Standard Apache directory 
Ee) conf Standard Apache directory 
L httpd.conf Main Apache configuration file 


J GWApache2.conf Specialized Apache configuration file for use with GroupWise 


Es) error Standard Apache directory 
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Z htdocs Apache document root directory 


LÌ index.html Web server default Web page 
E icons Standard Apache directory 
w logs Standard Apache directory 
il man Standard Apache directory 
m manual Standard Apache directory 
E modules Standard Apache directory 


SyS:\tomcat\4 


Tomcat installation directory 


w bin Standard Tomcat directory 
y common Standard Tomcat directory 
E conf Standard Tomcat directory 
y examples Standard Tomcat directory 
E logs Standard Tomcat directory 
y server Standard Tomcat directory 
E shared Standard Tomcat directory 
= temp Standard Tomcat directory 


z webapps/ROOT 


w webapps/gw 
index.html 


= com/novell 


z collexion 


= GWMonitor 


Standard Tomcat document root directory 


GroupWise-specific document root directory 
GroupWise default Web services page 


Directory for Novell product files 
Directory for Novell class files and properties files 


Directory for GroupWise Monitor files 


w help Subdirectory for Monitor Web console help files 

w images Subdirectory for Monitor Web console image files 
z images Directory for Novell product image files 

inso Directory for Inso* viewer files for viewing attachments 
T webaccess Directory for GroupWise WebAccess files 

w applets Subdirectory for WebAccess client properties files 

w help Subdirectory for WebAccess client help files 

= images Subdirectory for WebAccess client image files 


E webconsole 


= webpublisher 





Subdirectory for WebAccess Application Web console help 
files 


Directory for GroupWise WebPublisher files 


Ey help Subdirectory for WebPublisher help files 
m images Subdirectory for WebPublisher image files 
E WEB-INF Web server information directory 
LÌ web. xml Web server configuration file 


z classes/com/novell 


= collexion 


Directory for Novell product files 


Directory for language-specific morphology files 
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Sl GWMonitor 
= providers 
= templates 


H vebaccess 
a providers 
= templates 


H webpublisher 
E) providers 
= templates 


dal work 


= sys:\novell 


dal gwmonitor 
LJ gwmonitor.cfg 


w logs 


= webaccess 


webacc.cfg 
commgr.cfg 
spellchk.cfg 

m Idap.e£g 

= logs 

z temp 

= users 


z webpublisher 
LJ webpub.cfg 


J commgr.cfg 
W default 


w logs 


conf/httpd.conf file 


Directory for GroupWise Monitor files 
Subdirectory for service provider files 
Subdirectory for template files 


Directory for GroupWise WebAccess files 
Subdirectory for service provider files 
Subdirectory for template files 


Directory for GroupWise WebPublisher files 
Subdirectory for service provider files 
Subdirectory for template files 


Standard Tomcat directory 


Directory for Novell product configuration files 


Subdirectory for GroupWise Monitor 
Monitor Application configuration file 
Directory for Monitor Application log files 


Subdirectory for WebAccess 

WebAccess Application configuration file 
Communications Manager configuration file 
Novell Speller Application configuration file 
LDAP service provider configuration file 
Directory for WebAccess Application log files 
Temporary working directory 

Directory for WebAccess users’ session files 


Subdirectory for WebAccess Application files 
WebPublisher Application configuration file 
Communications Manager configuration file 
Subdirectory for boilerplate configuration files 
Subdirectory for WebPublisher Application log files 


The httpd.conf file is the main Apache configuration file. On NetWare, the GroupWise 
Installation program modifies it to include a reference to the GWApache2.conf file. 


conf/GWApache2.conf file 


The GWApache2. conf file includes the j kmount command that enables Apache and Tomcat to 


communicate with each other. 


htdocs/index.html file 


The index.html file in the htdocs directory is the default HTML file that displays in your Web 
browser when you go to the IP address or hostname of the server. 
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webapps/gw/index.html file 


The index.html file in the gw directory is the default HTML file for GroupWise Web services 
(WebAccess, WebPublisher, and Monitor) and displays when you go to the following URL: 
http://web_server address/gw 


From this default page, specific GroupWise URLs can be easily accessed: 


http://web_ server address/gw/webacc 
http://web server address/gw/webpub 
http://web server address/gw/gwmonitor 


WEB-INF/web.xml file 


The web. xml file tells the Web server where the various GroupWise service providers and their 
configuration files are located. By default, they are located in subdirectories under sys: \novell. 


GWMonitor/providers directory 


The providers directory holds the Java* class and properties files for the Monitor provider. For 
more information, see “Adding or Removing Service Providers” in “Monitor” in the GroupWise 7 
Administration Guide. 


GWMonitor/templates directory 


The templates directory holds subdirectories for the various file formats used in various browser 
environments. For more information, see “Modifying Monitor Application Template Settings” in 
“Monitor” in the GroupWise 7 Administration Guide. 


webaccess/providers directory 


The providers directory holds the Java class and properties files for the WebAccess providers. 
For more information, see “Adding or Removing Service Providers” in “WebAccess” in the 
GroupWise 7 Administration Guide. 


webaccess/templates directory 


The templates directory holds subdirectories for the various file formats used in various browser 
environments. For more information, see “Modifying WebAccess Application Template Settings” 
in “WebAccess” in the GroupWise 7 Administration Guide. 


webpublisher/providers directory 


The providers directory holds the Java class and properties files for the WebPublisher providers. 
For more information, see “Adding or Removing Service Providers” in “WebAccess” in the 
GroupWise 7 Administration Guide. 


webpublisher/templates directory 


The templates directory holds subdirectories for the various file formats used in various browser 
environments. For more information, see “Modifying WebPublisher Application Template Settings” 
in “WebAccess” in the GroupWise 7 Administration Guide. 
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sys:\novell directory 


The sys: \novell directory holds subdirectories for each Novell product that uses application 
configuration files. 


gwmonitor directory 


The gwmonitor directory is created when you install GroupWise Monitor. 


gwmonitor.cfg file 


The gwmonitor.cfg file holds the same configuration information that is stored on the Monitor 
Application object (named Group WiseMonitor) in eDirectory. For more information, see 
“Configuring the Monitor Application” in “Monitor” in the GroupWise 7 Administration Guide. 


logs directory 


The Logs subdirectory holds Monitor Application log files. For more information, see “Modifying 
Monitor Application Log Settings” in “Monitor” in the GroupWise 7 Administration Guide. 


webaccess directory 


The webaccess directory holds files used by the WebAccess Application. 


webacc.cfg file 


The webacc.cfg file holds the same configuration information that is stored on the WebAccess 
Application object (named Group WiseWebAccess) in eDirectory. For more information, see 
“Configuring the WebAccess Application” in “WebAccess” in the GroupWise 7 Administration 
Guide. 


commgr.cfg file 


The commgr . cfg file holds the same configuration information that is stored on the Group Wise 
Provider object (named GroupWiseProvider) in eDirectory, including the IP address, port number, 
number of threads, and encryption key for the WebAccess Agent. This information enables the 
WebAccess Application to communicate with the WebAccess Agent. For more information, see 
“Configuring the GroupWise Service Provider” in “WebAccess” in the GroupWise 7 Administration 
Guide. 


A copy of the commgr.cfg file is automatically maintained in the WebAccess Agent queue 
directory (domain\wpgate\webac70a). 


spellchk.cfg file 


The spellchk.cfg file holds the same configuration information that is stored on the Novell 
Speller Application object (named NovellSpeller) in eDirectory. For more information, see 
“Configuring the Novell Speller Application” in “WebAccess” in the GroupWise 7 Administration 
Guide. 


Idap.cfg file 


The ldap. cfg file holds the same configuration information that is stored on the LDAP Provider 
object (named LDAPProvider) in eDirectory. For more information, see “Configuring the LDAP 
Service Provider” in “WebAccess” in the GroupWise 7 Administration Guide. 
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logs directory 


The Logs subdirectory holds WebAccess Application log files. For more information, see 
“Controlling WebAccess Application Logging” in “WebAccess” in the GroupWise 7 
Administration Guide. 


users directory 


The users subdirectory holds session files for WebAccess users. If WebAccess times out after a 
period of user inactivity, the user’s session information is saved. When the user logs back in, the 
session information is retrieved so that the user can continue working without loss of data. Also, 
users’ message text is saved during each session, so that if the WebAccess Application is restarted 
or goes down, users do not lose the message text they were composing at the time. 


webpublisher directory 


The webpublisher directory holds files used by the WebPublisher Application. 


webpub.cfg 


The webpub . cfg file holds the same configuration information that is stored on the WebPublisher 
Application object (named GroupWiseWebPublisher) in eDirectory. For more information, see 
“Configuring the WebPublisher Application” in “WebAccess” in the GroupWise 7 Administration 
Guide. 


commgr.cfg file 


The commgr.cfg file holds the same configuration information that is stored on the GroupWise 
Provider object (named Group WiseProvider) in eDirectory, including the IP address, port number, 
number of threads, and encryption key for the WebAccess Agent. This information enables the 
WebAccess Application to communicate with the WebAccess Agent. For more information, see 
“Configuring the Group Wise Service Provider” in “WebAccess” in the GroupWise 7 Administration 
Guide. 


A copy of the commgr . cfg file is automatically maintained in the WebAccess Agent queue 
directory (domain\wpgate\webac70a). 


default directory 


The default directory holds boilerplate versions of the webpub.cfg and commgr.cfg files. 


logs directory 


The Logs subdirectory holds WebAccess Application log files. For more information, see 
“Controlling WebAccess Application Logging” in “WebAccess” in the GroupWise 7 
Administration Guide. 


8.5.2 Linux Installation Directory 


es) /opt/novell/httpd Novell Apache installation directory 
E] modules Standard Apache directory 


142 GroupWise 7 Troubleshooting 3: Message Flow and Directory Structure 


H] /etc/opt /novell/nttpd 

w conf.d 
al gconf.d 
EN] 


sslconf.d 


= /etc/opt/novell/tomcat4 

catalina.properties 

J jk2.properties 
server.xml 
tomcat-users.xml 

J tomcat4.conf 

J web.xml 

Ml init.d 

E logrotate.d 


w /var/opt/novell 


ra 


E ow 


O index.html 
= com/novell 
= collexion 


z images 
z inso 


H webaccess 
Ey applets 
w help 
Ey images 
En webconsole 


El webpublisher 
w help 
images 
E WEB-INF 
J web.xml 





= classes/com/novell 


= collexion 


webaccess 
m providers 
a templates 


Novell Apache configuration directory 
Standard Apache directory 
Standard Apache directory 
Standard Apache directory 


Novell Tomcat configuration directory 
Standard Tomcat file 

Standard Tomcat file 

Standard Tomcat file 

Standard Tomcat file 

Standard Tomcat file 

Web server configuration file 
Standard Tomcat directory 

Standard Tomcat directory 


Novell subdirectory under /var 


Apache document root directory for WebAccess and 
WebPublisher 


Web server default Web page 
Directory for Novell product files 
Directory for Novell class files and properties files 


Directory for Novell product image files 
Directory for Inso viewer files for viewing attachments 


Directory for GroupWise WebAccess files 
Subdirectory for WebAccess client properties files 
Subdirectory for WebAccess client help files 
Subdirectory for WebAccess client image files 


Subdirectory for WebAccess Application Web console help 
files 


Directory for GroupWise WebPublisher files 
Subdirectory for WebPublisher help files 
Subdirectory for WebPublisher image files 


Web server information directory 
Web server configuration file 


Web server configuration file 
Directory for language-specific morphology files 


Directory for GroupWise WebAccess files 
Subdirectory for service provider files 
Subdirectory for template files 
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H webpubli sher Directory for GroupWise WebPublisher files 





z providers Subdirectory for service provider files 
w templates Subdirectory for template files 
de] gwmon Apache document root directory for Monitor 
J index.html Web server default page 
Es) com/novell Directory for Novell product files 
Es) gwmonitor Directory for GroupWise WebPublisher files 
a help Subdirectory for WebPublisher help files 
= images Subdirectory for WebPublisher image files 
Es) WEB-INF Web server information directory 
Ll web. xml Web server configuration file 
E gwmonitor Directory for GroupWise Monitor files 
w providers Subdirectory for service provider files 
= templates Subdirectory for template files 
il httpd Standard Apache directory 
y log Standard Apache directory 
3 novlwww Home directory for the novlwww user created at installation 
E run Standard Apache directory 
= tomcat4 Standard Tomcat directory 
w bin Standard Tomcat directory 
= common Standard Tomcat directory 
= conf --> /etc/opt/novell/tomcat4 
z logs Standard Tomcat directory 
= server Standard Tomcat directory 
z shared Standard Tomcat directory 
= temp Standard Tomcat directory 
w webapps Standard Tomcat directory 
admin.xml Standard Tomcat file 
JJ manager .xml Standard Tomcat file 
examples Standard Tomcat directory 
— gw --> /var/opt/novell/gw 
w gwmon --> /var/opt/novell/gwmon 
= tomcat-docs Standard Tomcat directory 
E webdav Standard Tomcat directory 


gw/index.html file 


The index.html file in the gw directory is the default HTML file for GroupWise Web services 
(WebAccess and WebPublisher) and displays when you go to the following URL: 


http://web_server address/gw 


From this default page, specific GroupWise URLs can be easily accessed: 


http: //web_ server address/gw/webacc 
http://web_server address/gw/webpub 
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gw/WEB-INF/web.xml file 


md 


The web. xml file in the gw/WEB-INF directory tells the Web server where the various 
WebAccess service providers and their configuration files are located. By default, they are located 
in /opt/novell/groupwise/webaccess. 











webaccess/providers directory 


The providers directory holds the Java class and properties files for the WebAccess providers. 
For more information, see “Adding or Removing Service Providers” in “WebAccess” in the 
GroupWise 7 Administration Guide. 


webaccess/templates directory 


The templates directory holds subdirectories for the various file formats used in various browser 
environments. For more information, see “Modifying WebAccess Application Template Settings” 
in “WebAccess” in the GroupWise 7 Administration Guide. 


webpublisher/providers directory 


The providers directory holds the Java class and properties files for the WebPublisher providers. 
For more information, see “Adding or Removing Service Providers” in “WebAccess” in the 
GroupWise 7 Administration Guide. 


webpublisher/templates directory 


The templates directory holds subdirectories for the various file formats used in various browser 
environments. For more information, see “Modifying WebPublisher Application Template Settings” 
in “WebAccess” in the GroupWise 7 Administration Guide. 


gwmon/index.html file 


The index.html file in the gwmon directory is the default HTML file for the GroupWise Monitor 
Web service and displays when you go to the following URL: 
http://web_server address/gwmon 


From this default page, the GroupWise Monitor login page can be easily accessed: 


http://web server address/gwmon/gwmonitor 


gwmon/WEB-INF/web.xml file 








The web. xml file in the gwmon /WEB-INF directory tells the Web server where the Monitor 
service provider and its configuration file are located. By default, they are located in /opt / 
novell/groupwise/gwmonitor. 





gwmonitor/providers directory 


The providers directory holds the Java class and properties files for the Monitor provider. For 
more information, see “Adding or Removing Service Providers” in “Monitor” in the GroupWise 7 
Administration Guide. 
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gwmonitor/templates directory 


The templates directory holds subdirectories for the various file formats used in various browser 
environments. For more information, see “Modifying Monitor Application Template Settings” in 
“Monitor” in the GroupWise 7 Administration Guide. 
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Software Distribution Directory 


+ Section 9.1, “NetWare/Windows Software Distribution Directory,” on page 147 
¢ Section 9.2, “Linux Software Distribution Directory,” on page 153 


9.1 NetWare/Windows Software Distribution 
Directory 


W software distribution director Master copy of GroupWise® software 
E Y py p 


z agents 


LÌ install.exe 
= nlm 
E ne 


Lj wpdomain.dc 
gwdom.dc 


J wphost.dc 


J gwpo.dc 


BY po 
J ngwguard. dc 
wphost.dc 


Ll gwpo.dc 


W 


client 
H win32 
J setup.exe 


JJ setup.cfg 
H addons 


E] gwmailto 


y gwtip 


=| pdaconnect 


il gwcheck 
y ofviews 
z ppforms 
= uwl 


GroupWise agent software 
GroupWise Agent Installation program 
NetWare® agent software 

Windows agent software 

Agent startup files 

GroupWise MIB files 

Agent Web console help files 


Domain data dictionary files 
Data dictionary for GroupWise 4.x domain databases 


Data dictionary for GroupWise 7.x, 6.x, and 5.x domain 
databases 


Data dictionary for GroupWise 4.x post office 
databases 


Data dictionary for GroupWise 7.x, 6.x, and 5.x post 
office databases 


Post office data dictionary files 
Data dictionary for message store databases 


Data dictionary for GroupWise 4.x post office 
databases 


Data dictionary for GroupWise 7.x, 6.x, and 5.x post 
office databases 


GroupWise client software 

GroupWise client for Windows 

GroupWise client installation program 

Configuration file for the AutoUpdate feature 

GroupWise client addon programs 

Program to make GroupWise your browser e-mail 
program 

Program to display tips each time GroupWise starts 

Program to synchronize your PDA with GroupWise 

GroupWise Check utility 

GroupWise client view files 

GroupWise client day planner forms 

GroupWise client user word lists 
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H aamin 


GroupWise administrator software 


= cladmin GroupWise snap-ins to ConsoleOne® 
OY monitor GroupWise Monitor software 
WW utility GroupWise administrative utilities 
y gwcheck GroupWise Check utility 
E gwcsrgen GroupWise Generate CSR utility 
z setupip GroupWise TCP/IP Setup utility 
H internet Internet connectivity software 
= gwia GroupWise Internet Agent software 
H webaccess GroupWise WebAccess software 
3 license GroupWise Software License Agreement in multiple 
languages 
E common Java files used by GroupWise programs 
Es docs GroupWise Installation Guide 


9.1.1 \grpwise\software directory 


The GroupWise software distribution directory resides initially on the GroupWise Administrator 
CD. GroupWise Administration is installed directly from the CD. In addition, during installation, 
you create a software distribution directory on your network from which you subsequently install 
the GroupWise agents and GroupWise client software. 


The default software distribution directory is \grpwise\software. 


9.1.2 agents directory 


The agents subdirectory contains all files associated with GroupWise agents: 
+ Post Office Agent (POA) 
+ Message Transfer Agent (MTA) 
+ GroupWise Target Service Agent (GWTSA) 

install.exe file 


The install.exe file in the agent subdirectory is the installation program you run to install the 
Group Wise agents on the servers where you will run the POA and/or MTA. For instructions, see 
“Installing GroupWise Agents” in the GroupWise 7 Installation Guide. 


nim directory 


The nlm subdirectory in the agent subdirectory contains the GroupWise agent NLM™ files 
installed on NetWare servers. See “NetWare Installation Directory” on page 103. 


nt directory 


The nt subdirectory contains the GroupWise agent files installed on Windows servers. See 
“Windows Installation Directory” on page 111. 
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startups directory 


The startups subdirectory contains the default startup files for the GroupWise agents. During 
installation, a customized startup file is created for each agent that includes the location of the 
domain or post office serviced by that agent. The customized startup files are named after the 
domain or post office for which they are created. See “NetWare Installation Directory” on page 103 
or “Windows Installation Directory” on page 111. 


snmp directory 


The snmp subdirectory contains GroupWise MIB files. For more information, see “Using an SNMP 
Management Console” in “Post Office Agent” and “Message Transfer Agent” in the GroupWise 7 
Administration Guide. 


help directory 


The help directory holds the help files that you can view from the agent Web consoles. See “Using 
the POA Web Console” in “Post Office Agent” and “Using the MTA Web Console” in “Message 
Transfer Agent” in the GroupWise 7 Administration Guide. 


9.1.3 domain directory 


The domain subdirectory contains the files from which domains are created. 


wpdomain.dc file 


The wpdomain.dc file is the distribution copy of the data dictionary for rebuilding Group Wise 4.x 
domain databases (wedomain . db files) in secondary domains. 


If the wodomain.dc file is missing from the primary domain, you cannot rebuild GroupWise 4.x 
secondary domains. The original wodomain . dc file is located in the domain directory of the 
Group Wise distribution media. 


Historical Note: WordPerfect Office (WP Office), the predecessor of GroupWise, was originally 
designed by WordPerfect Corporation (WPCorp). Hence, the wp in wodomain.dc. Some naming 
conventions were originally preserved for backward compatibility. 


gwdom.dc file 


The gwdom. dc file is the distribution copy of the data dictionary for creating and rebuilding 
Group Wise 7.x, 6.x, and GroupWise 5.x domain databases (wpdomain. db files) in secondary 
domains. 


If the gwdom. dc file is missing from the primary domain, you cannot create or rebuild GroupWise 
7.x/6.x/5.x secondary domains. The original gwdom. dc file is located in the domain subdirectory 
of the GroupWise distribution media. 


Historical Note: WP Office, the predecessor of Group Wise, was originally designed by WordPerfect 
Corporation (WPCorp). Hence, the wp in wodomain.db. Some naming conventions were 
originally preserved for backward compatibility. 
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wphost.dc file 


The wphost . de file is the distribution copy of the data dictionary for rebuilding GroupWise 4.x 
post office databases (wphost . db files). 


If the wehost . de file is missing from a domain, you cannot rebuild GroupWise 4.x post offices in 
that domain. The original wohost. de file is located in the domain subdirectory of the 
Group Wise distribution media. There is also a copy in the po subdirectory. 


Historical Note: WP Office, the predecessor of GroupWise, was originally designed by WordPerfect 
Corporation (WPCorp). Post offices were originally called hosts. Hence, the name wphost .dc. 
Some naming conventions were originally preserved for backward compatibility. 


gwpo.dc file 


The gwpo. dc file is the distribution copy of the data dictionary for creating and rebuilding 
GroupWise 7.x, 6.x, and GroupWise 5.x post office databases (wphost.db files). 


If the gwpo. de file is missing from a domain, you cannot create or rebuild GroupWise 7.x/6.x/5.x 
post offices in that domain. The original gwpo. dc file is located in the domain directory of the 
GroupWise Administrator CD. There is also a copy in the po directory. 


Historical Note: WP Office, the predecessor of GroupWise, was originally designed by WordPerfect 
Corporation (WPCorp). Post offices were originally called hosts. Hence, the name wphost .db. 
Some naming conventions were originally preserved for backward compatibility. 


9.1.4 po directory 


The po subdirectory contains the files from which post offices are created. 


ngwguard.dc file 


The ngwguard . dc file is the distribution copy of the data dictionary for building the following 
databases in the post office: 

+ ngwguard. db (guardian database) 

+ dmxxnn01-FF (document management databases) 

+ msgnnn.db (message databases) 

+ userxxx.db (user databases) 

+ puxxxxx.db (databases for replicated items like shared folders) 
If the ngwguard. de file is missing from a post office, new databases cannot be created in the post 


office, so the post office cannot grow. The original ngwguard. dc file is located in the po 
directory of the GroupWise Administrator CD. 


In Remote mode, the GroupWise client also uses the ngwguard. dc file as the data dictionary for 
1ts local databases. 


9.1.5 client directory 


The client subdirectory contains all files associated with GroupWise Windows client. See 
“Client” in the GroupWise 7 Administration Guide. 
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win32 directory 


The win32 subdirectory contains all GroupWise client files installed for use with Windows. See 
Section 10.1, “Windows Client,” on page 163. 


setup.exe file 


The setup.exe file is the program GroupWise client users run to install and set up the Group Wise 
client on their Windows workstations. See “Client” in the GroupWise 7 Administration Guide. 


setup.cfg file 


The setup.cfg file enables you to automate installation of the GroupWise Windows client so that 
your users do not need to respond to the Setup program’s prompts. For more information, see 
“Installing with the Configuration File (setup.cfg)” in “Client” in the GroupWise 7 Administration 
Guide. 


addons directory 


The addons directory contains subdirectories for programs that can be used along with the 
GroupWise client to enhance aspects of its functionality. 


gwmailto directory 


The gwmailto directory contains a program that makes the GroupWise Windows client the default 
e-mail application in your Web browser. For more information, see “[GWMAILTO]” in “Modifying 
the Configuration File” in “Client” in the GroupWise 7 Administration Guide. 


gwtip directory 


The gwtip directory contains a program that display a helpful tip about GroupWise each time the 
client starts. For more information, see “[GWTIP] ” in “Modifying the Configuration File” in 
“Client” in the GroupWise 7 Administration Guide. 


pdaconnect directory 


The pdaconnect directory contains a program to synchronize data between GroupWise and a 
PDA device. For more information, see the PDA Connect Readme (http://www.novell.com/ 
documentation/gw7/readmeen_pda_connect/readmeen_pda_connect.html). 


9.1.6 gwcheck directory 


The gwcheck subdirectory contains the GroupWise Check utility that can be made available in the 
Group Wise client by clicking Tools > Repair Mailbox. For more information, see “Repairing Your 
Mailbox” in “Managing Your Mailbox” in the GroupWise 7 Windows Client User Guide. 


9.1.7 ofviews directory 


The ofviews subdirectory contains platform-specific subdirectories of view files for use by the 
GroupWise client. In addition, the gwviewxx.ini and ofviewxx. ini files configure custom 
views on the menus where users select views. The gwviewxx. ini file configures GroupWise 7.x, 
6.x, and GroupWise 5.5 views. The ofviewxx. ini file configures views from earlier versions of 
GroupWise. 
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9.1.8 ppforms directory 


The ppforms subdirectory contains day planner forms for printing Group Wise calendars and tasks. 


9.1.9 uwl directory 

The uwl directory stores the wt 61xx.uwl files that are used when users add words to the word 
list during spell checking. 

9.1.10 admin directory 


The admin subdirectory contains subdirectories for administrative tools that can be used with 
Group Wise. 


cladmin directory 


The admin\cladmin subdirectory contains the GroupWise snap-ins to ConsoleOne. 


monitor directory 


The admin\monitor subdirectory contains the GroupWise 7.x/6.x Monitor program, an SNMP 
monitoring program for use with the GroupWise agents. See “Monitor” in the GroupWise 7 
Administration Guide. 


utility directory 
The admin\utility subdirectory contains helpful GroupWise utilities. 
gwcheck directory 


The admin\utility\gwcheck subdirectory contains the GroupWise Check utility. See 
“GroupWise Check” in “Standalone Database Maintenance Programs” in the GroupWise 7 
Administration Guide. 


gwcsrgen directory 


The admin\utility\gwcsrgen subdirectory contains the GroupWise Generate CSR utility. 
See “Server Certificates and SSL Encryption” in “Security Administration” in the GroupWise 7 
Administration Guide. 


setupip directory 


The admin\utility\setupip subdirectory contains supporting programs for the client 
AutoUpdate feature. See “Enabling AutoUpdate” in “Client” in the GroupWise 7 Administration 
Guide. 


9.1.11 internet directory 


The internet subdirectory contains subdirectories for GroupWise components that provide 
Internet connectivity. 
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gwia directory 


The internet\gwia subdirectory contains the GroupWise Internet Agent software, used to 
connect Group Wise systems across the Internet and to allow GroupWise users to exchange e-mail 
with users of various Internet e-mail programs. For information about Internet Agent files and 
directories, see Section 7.4, “Internet Agent Queue Directory,” on page 85 and Section 8.2, “Internet 
Agent Installation,” on page 114. 


For information about the Internet Agent, see “Internet Agent” in the GroupWise 7 Administration 
Guide. 


webaccess directory 


The internet \webaccess subdirectory contains the GroupWise WebAccess software, which 
allows users to access their GroupWise mailboxes from a Web browser. For information about 
WebAccess files and directories, see Section 7.5, “WebAccess Agent Queue Directory,” on page 92, 
Section 8.3, “WebAccess Agent Installation,” on page 121, and Section 8.5, “Apache/Tomcat 
Installation,” on page 137 





For information about WebAccess, see “WebAccess” in the GroupWise 7 Administration Guide. 


9.1.12 license directory 


The License subdirectory contains the GroupWise Software License Agreement in multiple 
languages. Run license. exe, then select a language. 


9.1.13 common directory 


The common subdirectory contains Java files used by various components of Group Wise. 


9.1.14 docs directory 


The docs subdirectory contains language-specific subdirectories for the Installation Guide in PDF 
format. You can find the most up-to-date version of the GroupWise 7 Installation Guide on the 
GroupWise 7 Documentation Web site (http://www.novell.com/documentation/gw7). 


9.2 Linux Software Distribution Directory 


wm, opt/novell/groupwise/software Master copy of GroupWise software 
J install GroupWise Installation script 
BD agents GroupWise agent software 
E linux Subdirectory for Linux software 

LJ novell-groupwise-agents- GroupWise agent package 
ver.date.i386.rpm 

Lj novell-groupwise-gwha- GroupWise High Availability service package 
ver.date.i386.rpm 

Ll novell-sms-ver.i586. rpm Novell® Storage Management Services™ 

package 
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H startups 
language 
strtupxx.poa 
J strtupxx.mta 
LJ grpwise 


2 domain 
O wpdomain.dc 
L gwdom.dc 


J wphost.dc 


J gwpo.dc 


na 


Z po 
J ngwguard.dc 
O wphost.dc 
J gwpo.dc 


H client 
= linux 
Ll install 
Ll novell-groupwise-gwclient- 
ver.date.i386.rpm 
novell-groupwise-gwcheck- 
ver. date.i386.rpm 
= ofviews 


E admin 

novell-groupwise-admin- 
ver. date.i386.rpm 

LJ novell-groupwise-dbcopy- 
ver. date.i386.rpm 

= novell-groupwise-gwcheck- 
ver. date.i386.rpm 





| NOVLclLinuxjre-ver.i386.rpm 


J novell-groupwise-gwmon- 
ver.date.i386.rpm 
J novell-groupwise-monitor- 
ver.date.i386.rpm 
E startup 
L grpwise-ma 
Ll S99grpwise-ma 


E internet 


Subdirectory for startup files 

Language-specific files 

POA startup file 

MTA startup file 

GroupWise agent startup script (POA and MTA) 


Domain data dictionary files 
Data dictionary for GW 4.x domain databases 


Data dictionary for GW 7.x, 6.x, and 5.x domain 
databases 


Data dictionary for GW 4.x post office databases 


Data dictionary for GW 7.x, 6.x, and 5.x post 
office databases 


Post office data dictionary files 
Data dictionary for message store databases 
Data dictionary for GW 4.x post office databases 


Data dictionary for GW 7.x, 6.x, and 5.x post 
office databases 


GroupWise client software 
Subdirectory for Linux software 
Cross-Platform client installation script 
Cross-Platform client package 


GroupWise Check Utility package 


GroupWise client view files 

GroupWise administrator software 
GroupWise snap-ins to ConsoleOne package 
GroupWise Database Copy Utility package 


GroupWise Check Utility package 


ConsoleOne JRE update package 


GroupWise Monitor software 
Subdirectory for Linux software 
Monitor Agent package 


Monitor Application package 


Subdirectory for startup files 
Monitor startup script 
Monitor startup script for automatic start on reboot 


Internet connectivity software 
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H oia 
= linux 
LJ novell-groupwise-gwia- 
ver. date.i386.rpm 
J novell-groupwise-gwha- 
ver.date.i386.rpm 
= root 
LJ gwia.cfg 
LJ gwauth.cfg 
LJ mimetype.cfg 
J gwac.dc 


J preamble. txt 

J preamble.all 
= LJ statusxx. xml 
z startup 


LJ grpwise 


Mil vebacces 
E Linux 
J novell-groupwise-gwinter- 
ver.date.i386.rpm 


J novell-groupwise- 
webaccess-ver.date.i386.rpm 


= root 
J mimetype.cfg 


gwac.dc 


LJ grpwise 
J S99grpwise 


H webserver 
= linux 
LJ * pm 


license 


W 


W 


docs 


E] gwinst 


GroupWise Internet Agent software 
Subdirectory for Linux software 
GroupWise Internet Agent package 


GroupWise High Availability service package 


Subdirectory for boilerplate supporting files 
Internet Agent startup file 

Host authentication configuration file 
MIME encoding configuration file 


Database dictionary for the access control 
database 


Message for non-MIME recipients 
Preamble message in various languages 
File for customizing status messages 
Subdirectory for startup files 

Internet Agent startup script 


GroupWise WebAccess software 
Subdirectory for Linux software 
GroupWise WebAccess Agent package 


GroupWise WebAccess Application package 


Subdirectory for boilerplate supporting files 
MIME encoding configuration file 


Database dictionary for the access control 
database 


Gateway identifier file 
Subdirectory for startup files 
WebAccess Agent startup script 


WebAccess Agent startup script for automatic 
start on reboot 


Web server to support WebAccess and Monitor 
Subdirectory for Linux software 
Apache, Tomcat, and related packages 


GroupWise Software License Agreement in 
multiple languages 


GroupWise Readme, Quick Start, and Installation 
Guide 


Directories and files used by the Installation 
program 


9.2.1 /opt/novell/groupwise/software directory 


The GroupWise software distribution directory resides initially on the GroupWise Administrator 
CD. GroupWise Administration is installed directly from the CD. In addition, during installation, 
you can create a software distribution directory on your network from which you subsequently 
install the GroupWise agents and GroupWise client software. 
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The default software distribution directory is /opt/novell/groupwise/software. 


install file 


The instal1 file is the script you use to install all components of GroupWise on Linux. See 
“Linux: Setting Up a Basic GroupWise System” in the GroupWise 7 Installation Guide. 


9.2.2 agents directory 


The agents subdirectory contains all files associated with GroupWise agents: 


+ Post Office Agent (POA) 
+ Message Transfer Agent (MTA) 


novell-groupwise-agents. version. date.i386.rpm 


The novell-groupwise-agents. version. date.i386.rpmfile is the GroupWise agent 
package that is installed by the Installation script. It installs the POA and the MTA. You can install 
the agent package manually if necessary. To see what files are installed by the package, see 

Section 8.1.2, “Linux Installation Directory,” on page 106. 


novell-groupwise-gwha. version. date.i386.rpm 


The novell-groupwise-gwha. version. date.i386.rpm file is the GroupWise High 
Availability service package that is installed by the Installation script. It is automatically installed 
along with the POA and the MTA. You can install the High Availability package manually if 
necessary. To see what files are installed by the package, see Section 8.1.2, “Linux Installation 
Directory,” on page 106. 


novell-sms-version.i586.rpm 


The novell-sms-version.i586.rpm file is the Novell Storage Management Services 
package that is used in conjunction with the Service Agent for File Systems (TSAFS) and TSAFS 
for GroupWise (TSAFSGW) for the purpose of backing up GroupWise databases in a live 

Group Wise system. It is not installed by the Installation script but must be installed manually, as 
described in “Linux: Running TSAFS and TSAFSGW” in “Databases” in the GroupWise 7 
Administration Guide. 


startups directory 


The startups subdirectory contains the default startup files for the GroupWise agents. During 
installation, a customized startup file is created for each agent that includes the location of the 
domain or post office serviced by that agent. The customized startup files are named after the 
domain or post office for which they are created. See Section 8.1.2, “Linux Installation Directory,” 
on page 106. 


grpwise file 


The grpwise file is the GroupWise agent startup script. It is installed in /etc/init.d. Ifyou 
choose to have the agents start automatically when the server reboots, the Installation script places 
symbolic links to it named S99grpwise in the rc3.d and rc5.d subdirectories of /etc/ 
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init.d. For more information, see “Installing and Starting the Linux GroupWise Agents” in 
“Installing a Basic GroupWise System” in the GroupWise 7 Installation Guide. 


9.2.3 domain directory 


The domain subdirectory contains the files from which domains are created. 


wpdomain.dc file 


The wpdomain.dc file is the distribution copy of the data dictionary for rebuilding Group Wise 4.x 
domain databases (wpdomain . db files) in secondary domains. 


If the wodomain.dc file is missing from the primary domain, you cannot rebuild GroupWise 4.x 
secondary domains. The original wodomain . dc file is located in the domain directory of the 
Group Wise distribution media. 


Historical Note: WordPerfect Office (WP Office), the predecessor of GroupWise, was originally 
designed by WordPerfect Corporation (WPCorp). Hence, the wp in wodomain.dc. Some naming 
conventions were originally preserved for backward compatibility. 


gwdom.dc file 


The gwdom. dc file is the distribution copy of the data dictionary for creating and rebuilding 
Group Wise 7.x, 6.x, and 5.x domain databases (wpdomain. db files) in secondary domains. 


If the gwdom. dc file is missing from the primary domain, you cannot create or rebuild GroupWise 
7.x/6.x/5.x secondary domains. The original gwdom. de file is located in the domain subdirectory 
of the GroupWise distribution media. 


Historical Note: WP Office, the predecessor of GroupWise, was originally designed by WordPerfect 
Corporation (WPCorp). Hence, the wp in wedoma in. db. Some naming conventions were 
originally preserved for backward compatibility. 


wphost.dc file 


The wphost . dae file is the distribution copy of the data dictionary for rebuilding GroupWise 4.x 
post office databases (wphost . db files). 


If the wohost. de file is missing from a domain, you cannot rebuild GroupWise 4.x post offices in 
that domain. The original wphost. dc file is located in the domain subdirectory of the 
Group Wise distribution media. There is also a copy in the po subdirectory. 


Historical Note: WP Office, the predecessor of GroupWise, was originally designed by WordPerfect 
Corporation (WPCorp). Post offices were originally called hosts. Hence, the name wphost .dc. 
Some naming conventions were originally preserved for backward compatibility. 


gwpo.dc file 


The gwpo. dc file is the distribution copy of the data dictionary for creating and rebuilding 
GroupWise 7.x, 6.x, and 5.x post office databases (wphost . db files). 


If the gwpo.dc file is missing from a domain, you cannot create or rebuild GroupWise 7.x/6.x/5.x 
post offices in that domain. The original gwpo . dc file is located in the domain directory of the 
GroupWise Administrator CD. There is also a copy in the po directory. 
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Historical Note: WP Office, the predecessor of Group Wise, was originally designed by WordPerfect 
Corporation (WPCorp). Post offices were originally called hosts. Hence, the name wphost . db. 
Some naming conventions were originally preserved for backward compatibility. 


9.2.4 po directory 


The po subdirectory contains the files from which post offices are created. 


ngwguard.dc file 


The ngwguard. dc file is the distribution copy of the data dictionary for building the following 
databases in the post office: 

+ ngwguard. db (guardian database) 

+ dmxxnn01-FF (document management databases) 

+ msgnnn.db (message databases) 

+ userxxx.db (user databases) 

+ puxxxxx.db (databases for replicated items like shared folders) 
If the ngwguard. de file is missing from a post office, new databases cannot be created in the post 


office, so the post office cannot grow. The original ngwguard. dc file is located in the po 
directory of the GroupWise Administrator CD. 


In Remote mode, the GroupWise client also uses the ngwguard. dc file as the data dictionary for 


its local databases. 


9.2.5 client directory 


The client subdirectory contains all files associated with GroupWise Windows client. See 
“Client” in the GroupWise 7 Administration Guide. 


install file 


The instal1 file is the script that GroupWise Cross-Platform client users run to install and set up 
the GroupWise client on their Linux or Macintosh* workstations. See “Setting Up the GroupWise 
Cross-Platform Client on Linux” in the GroupWise 7 Installation Guide. 


novell-groupwise-gwclient-version.date.i386.rpm 


The novel1-groupwise-client.version.date.1386. rpm file is the GroupWise client 
package that is installed by the Installation script. You can install the client package manually if 
necessary. To see what files are installed by the package, see Section 10.2, “Cross-Platform Client 
on Linux,” on page 166. 


novell-groupwise-gwcheck-version.date.i386.rpm file 





The novell-groupwise-gwcheck. version. date.i386.rpm file is the GroupWise 
Check utility package. It is not installed by the Installation script but must be installed manually, as 
described in “Using GWCheck on Linux” in “Databases” in the GroupWise 7 Administration Guide. 
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9.2.6 ofviews directory 


The client\ofviews subdirectory contains platform-specific subdirectories of view files for 
use by the Group Wise client. On Linux, the win subdirectory contains the view files for the 
Windows client, so that users on a Linux post office can use the Windows client if desired. The 
Cross-Platform client does not use view files like the Windows client does. 


In addition, the gwviewxx.ini and ofviewxx. ini files configure custom views on the menus 
where users select views in the Windows client. The gwviewxx.ini file configures GroupWise 
7.x, 6.x, and 5.5 views. The ofviewxx. ini file configures views from earlier versions of 

Group Wise. 


9.2.7 admin directory 


The admin subdirectory contains subdirectories for administrative tools that can be used with 
Group Wise. 


novell-groupwise-admin-version.date.i386.rpm file 


The novell-groupwise-admin.version.date.i386.rpm file is the GroupWise 
administrator package that is installed by the Installation script. It contains the GroupWise 
Administrator snap-ins to ConsoleOne. You can install the admin package manually if necessary. 


novell-groupwise-dbcopy-version.date.i386.rpm file 


The novell-groupwise-dbcopy.version.date.i386.rpm file is the GroupWise 
Database Copy utility package. It is not installed by the Installation script but must be installed 
manually, as described in “Using DBCopy on Linux” in “Databases” in the GroupWise 7 
Administration Guide. 


novell-groupwise-gwcheck-version.date.i386.rpm file 





The novell-groupwise-gwcheck. version. date.i386.rpm file is the GroupWise 
Check utility package. It is not installed by the Installation script but must be installed manually, as 
described in “Using GWCheck on Linux” in “Databases” in the GroupWise 7 Administration Guide. 


NOVLc1Linuxjre-version.i386.rpm file 


The NOVLc1Linuxjre-version.i386.rpm file is the package that updates ConsoleOne so 
that it is compatible with the GroupWise Administrator snap-ins. It is installed for you automatically 
when you install GroupWise administration. 


monitor directory 


The monitor subdirectory contains the GroupWise Monitor software. See “Monitor” in the 
GroupWise 7 Administration Guide. 


novell-groupwise-gwmon-version.date.i386.rpm file 


The novell-groupwise-gwmon. version. date.i386.rpm file is the GroupWise 
Monitor Agent package that is installed by the Installation script. You can install the package 
manually if necessary. To see what files are installed by the package, see Section 8.4, “Monitor 
Agent Installation,” on page 133 and Section 8.5, “Apache/Tomcat Installation,” on page 137. 
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novell-groupwise-monitor-version.date.i386.rpm file 


The novell-groupwise-monitor. version. date.i386.rpm file is the GroupWise 
Monitor Application package that is installed by the Installation script. You can install the package 
manually if necessary. To see what files are installed by the package, see Section 8.4, “Monitor 
Agent Installation,” on page 133 and Section 8.5, “Apache/Tomcat Installation,” on page 137. 


grpwise-ma file 


The grpwise-ma file is the Monitor Agent startup script. During installation, it is placed in / 
etc/ init. d. For more information, see “Starting the Linux Monitor Agent as a Daemon” in 
“Installing GroupWise Monitor” in the GroupWise 7 Installation Guide. 


S99grpwise-ma file 


The S99grpwise-ma file is the Monitor Agent startup script that is placed in the rc3.d and 
rc5.d subdirectories of /etc/init.dif you choose to have the Monitor Agent start 
automatically when the server reboots. For more information, see “Starting the Linux Monitor 
Agent as a Daemon” in “Installing GroupWise Monitor” in the GroupWise 7 Installation Guide. 


9.2.8 internet directory 


The internet subdirectory contains subdirectories for GroupWise components that provide and 
support Internet connectivity. 


gwia directory 


The gwia subdirectory contains the Internet Agent software, used to connect GroupWise systems 
across the Internet and to allow Group Wise users to exchange e-mail with users of various Internet 
e-mail programs. See “Internet Agent” in the GroupWise 7 Administration Guide. 


novell-groupwise-gwia-version.date.i386.rpm file 


The novell-groupwise-gwia. version. date.i386.rpm file is the Internet Agent 
package that is installed by the Installation script. You can install the package manually if necessary. 
To see what files are installed by the package, see Section 8.2, “Internet Agent Installation,” on 
page 114. 


novell-groupwise-gwha. version.date.i386.rpm 


The novell-groupwise-gwha. version. date.i386.rpm file is the GroupWise High 
Availability service package that is installed by the Installation script. It is automatically installed 
along with the Internet Agent. You can install the High Availability package manually if necessary. 
To see what files are installed by the package, see Section 8.2.2, “Linux Installation Directory,” on 
page 116. 


root directory 


The root directory contains boilerplate versions of the configuration files that are installed to the 
Internet Agent root directory under the domain directory. For more information, see Section 7.4, 
“Internet Agent Queue Directory,” on page 85. 
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grpwise file 


The grpwise file is the Internet Agent startup script. During installation, it is placed in /etc/ 
init.d. If you choose to have the Internet Agent start automatically when the server reboots, the 
Installation script places symbolic links to it named S99grpwise in the rc3.d and rc5.d 
subdirectories of /etc/init.d. For more information, see “Linux: Starting the Internet Agent” in 
“Installing the GroupWise Internet Agent” in the GroupWise 7 Installation Guide. 


webacces directory 


The internet \webacces subdirectory contains the GroupWise WebAccess software, which 
allows users to access their GroupWise mailboxes from a Web browser. See “WebAccess” in the 
GroupWise 7 Administration Guide. 





novell-groupwise-gwinter-version.date.i386.rpm file 


The novell-groupwise-gwinter. version. date.i386.rpm file is the WebAccess 
Agent package that is installed by the Installation script. You can install the package manually if 
necessary. To see what files are installed by the package, see Section 8.3, “WebAccess Agent 
Installation,” on page 121. 


novell-groupwise-webaccess-version.date.i386.rpm file 





The novell-groupwise-webaccess.version.date.i386.rpm file is the WebAccess 
Application package that is installed by the Installation script. You can install the package manually 
if necessary. To see what files are installed by the package, see Section 8.3, “WebAccess Agent 
Installation,” on page 121 and Section 8.5, “Apache/Tomcat Installation,” on page 137. 


root directory 


The root directory contains boilerplate versions of the configuration files that are installed to the 
WebAccess Agent root directory under the domain directory. For more information, see Section 7.5, 
“WebAccess Agent Queue Directory,” on page 92. 


grpwise file 


The grpwise file is the WebAccess Agent startup script. During installation, it is placed in /etc/ 
init.d. For more information, see “Starting the Linux WebAccess Agent” in “Installing 
GroupWise WebAccess” in the GroupWise 7 Installation Guide. 


S99grpwise file 


The S99grpwise file is the WebAccess Agent startup script that is placed in the rc3.d and 
rc5.d subdirectories of /etc/init.dif you choose to have the WebAccess Agent start 
automatically when the server reboots. During installation, it is named grpwise and placed in / 
etc/init.d. For more information, see “Starting the Linux GroupWise Agents on System 
Startup” in “Installing GroupWise Agents” in the GroupWise 7 Installation Guide. 


webserver directory 


On Linux, you can install Apache and Tomcat along with WebAccess and Monitor. This 
automatically integrates WebAccess and Monitor into Apache and Tomcat for you. If you are 
already running Apache and Tomcat, you can choose to integrate WebAccess and Monitor into that 
installation, or you can have two Apache/Tomcat installations on your server. WebAccess and 
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Monitor cannot be used without a supporting Web server. For more information, see “Determining 
the WebAccess and WebPublisher Applications' Configuration” in “Installing Group Wise 
WebAccess” and “Determining the Monitor Application's Configuration” in “Installing GroupWise 
Monitor” GroupWise 7 Installation Guide. 


9.2.9 license directory 


The License subdirectory contains the GroupWise Software License Agreement in multiple 
languages. Use the more command to view the License Agreement. 


9.2.10 docs directory 


The docs subdirectory contains language-specific subdirectories for the GroupWise 7 Installation 
Guide and Quick Start in PDF format, along with the Readme in HTML format. You can find the 
most up-to-date version of the GroupWise documentation on the GroupWise 7 Documentation Web 
site (http://www.novell.com/documentation/gw7). 


9.2.11 gwinst directory 


The gwinst subdirectory contains supporting files and subdirectories used by the Installation 
script. 
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GroupWise Client Installation 


Directories 


¢ Section 10.1, “Windows Client,” on page 163 


+ Section 10.2, “Cross-Platform Client on Linux,” on page 166 


¢ Section 10.3, “Cross-Platform Client on Macintosh,” on page 168 


10.1 Windows Client 


So: \novell\groupwise Installation directory for GroupWise® 7.x Windows client software 


J grpwise.e 
gwtip.exe 
notify.ex 

Ll addrbook 


J htrsetup. 
LJ gwimpexe. 
LJ gwmailto 
J gwreload. 
| gwsync.ex 


pdaconnect.exe 


Ll ngwguard. 
wprof.dc 


egi 
E X OGK 
L «fit 
Ll * Chm 
3 gwcheck 


H otviews 
= win 


xe 


e 


.«EXe 


exe 


exe 


«EXe 


exe 


e 


de 


LJ * Vew 
Ox. ini 


ee] ppforms 
J= «DEP 


Ll «pr 


S 


GroupWise client program 
GroupWise Tip of the Day program 
GroupWise Notify program 
GroupWise Address Book program 


Hit the Road setup program 
GroupWise E-Mail Importer Utility 
Web browser support program 
Mailbox mode switching program 
Mailbox synchronization program 
PDA Connect Installation program 


Data dictionary for databases 
Data dictionary for Remote Address Book 


DLL programs to support GroupWise Windows client 
OLE custom controls 

Graphics filters for Inso viewers 

Help files to support the GroupWise client 
GroupWise Check utility 


GroupWise view files 

GroupWise view files for Windows 
View files 

View initialization files 


Day planner forms 
Form description files 
Print resource files 
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10.1.1 c:\novell\groupwise 


The GroupWise Windows client installation directory contains all files necessary to run the 
GroupWise client. The default location is c: \novell\groupwise. 


+ For a standard installation, the GroupWise client directory resides on the user’s workstation. 


+ Fora workstation installation, the GroupWise client directory resides on the network and is run 
by users on many workstations. 


+ Fora remote GroupWise installation, the Group Wise directory contains the same files as would 
be installed on a workstation connected to the network. Whenever GroupWise cannot make a 
network connection, it checks for a Remote mailbox to access. See Section 7.7, “Remote 
Mailbox Directory,” on page 98. 


10.1.2 grpwise.exe file 


The grpwise.exe file is the GroupWise 7.x client program for use with Windows. 


10.1.3 gwtip.exe file 


The gwtip.exe file is the GroupWise Tip of the Day program, which displays helpful information 
about a GroupWise feature each time you start the Group Wise client. 


10.1.4 notify.exe file 


The notify.exe file is the program that alerts you whenever you have incoming items, when 
your outgoing items are opened, or when you have an upcoming appointment. Notify can alert you 
in four ways: a sound, a dialog box, a small icon, or by launching an application. 


10.1.5 addrbook.exe file 


The addrbook. exe file is the program that accesses the GroupWise Address Book. The Address 
Book contains information for all Novell® eDirectory™ users, GroupWise external users, 
Group Wise external entities, Group Wise e-mail distribution lists, and so on. 


10.1.6 htrsetup.exe file 


The htrsetup. exe file is the setup program for Hit the Road, which creates your Remote 
mailbox. See “Remote Mode” in “Client” in the GroupWise 7 Administration Guide. 


10.1.7 gwimpexe.exe file 
The gwimpexe . exe file is the GroupWise E-Mail Importer Utility, which enables you to import 


supported POP3/IMAP4 accounts into GroupWise. See “Importing POP3 and IMAP4 Accounts” in 
“Working with Items in Your Mailbox” in the GroupWise 7 Windows Client User Guide. 


10.1.8 gwmailto.exe file 


The gwmailto.exe file is the program that integrates the GroupWise client with your Web 
browser. If you select Internet Browser Mail Integration during installation, the Group Wise client 
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becomes the default e-mail program on your workstation. See “Setting Up the GroupWise Client” in 
“Installing the GroupWise Windows and Cross-Platform Clients” in the GroupWise 7 Installation 
Guide. 


10.1.9 gwreload.exe file 
The gwreload.exe file is the program that restarts the GroupWise client when you switch 


between Online, Caching, and Remote modes. See “Using Caching Mode” and “Using Remote 
Mode” in the GroupWise 7 Windows Client User Guide. 


10.1.10 gwsync.exe file 


The gwsync.exe file is the program that synchronizes your Online and Caching mailboxes. See 
“Using Caching Mode” in the GroupWise 7 Windows Client User Guide. 


10.1.11 pdaconnect.exe file 


The pdaconnect . exe file is the PDA Connect Installation program for synchronizing data 
between GroupWise and a PDA device. For more information, see the PDA Connect Readme (http:/ 
/www.novell.com/documentation/gw7/readmeen_pda_connect/readmeen_pda_connect.html). 


10.1.12 ngwguard.dc file 


The ngwguard.dc file is the data dictionary for building databases in the post office. In Remote 
mode, the GroupWise client also uses the ngwguard.dc file as the data dictionary for its local 
databases. 


10.1.13 wprof.dc file 


The wprof .dc file is the data dictionary for the remote GroupWise Address Book (wprof . db). 


Historical Note: An earlier version of the GroupWise client Remote mode, designed by WordPerfect 
Corporation (WPCorp), was named WP Office Remote. Hence, the worof in worof.dc. Some 
naming conventions were originally preserved for backward compatibility. 


10.1.14 *.dll files 
* .d11 files are dynamically linked libraries of program code used by executable programs. 


Language-independent * . d11 files are typically located in the same directory with the executable 
programs they support. Language-specific * .d11 files are grouped into subdirectories by language. 


10.1.15 *.ocx files 


* . ocx files are OLE custom controls. For example, * . ocx files control the Address Book and 
name completion. 
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10.1.16 *.flt files 


* . flt files are graphics filters used by the Inso viewers incorporated into the Group Wise client. 
The viewers enable you to view a wide variety of file types from within GroupWise. 


10.1.17 *.chm files 


* . chm files contain the online documentation for all components of GroupWise. * . chm files are 
typically located in the same directory with the executable programs they support. 


10.1.18 gwcheck directory 


The gwcheck directory contains the GroupWise Check utility that can be made available in the 
Group Wise client by clicking Tools > Repair Mailbox. For more information, see “Repairing Your 
Mailbox” in “Managing Your Mailbox” in the GroupWise 7 Windows Client User Guide. 


10.1.19 ofviews directory 


The ofviews directory contains platform-specific subdirectories of view files for use by the 
Group Wise client. 


Historical Note: An earlier version of GroupWise, designed by WordPerfect Corporation (WPCorp), 
was named WP Office. Hence, the of in ofviews. Some naming conventions were originally 
preserved for backward compatibility. 


win directory 


The win subdirectory contains view (* . vew) files for use by the GroupWise client. It also contains 
initialization (* . ini) files to control display of views. 


10.1.20 ppforms directory 
The ppforms directory contains day planner forms for printing Group Wise calendars and tasks. 


* bfp files 


* .bfp files are form description files that contain binder, filler, and page attributes for forms. 


*_prs files 


* .prs files are print resource files that indicate which forms are available for which languages. For 
example, day planners used by English-speaking people in the United States have different forms 
from day planners used for various languages in Europe. 


10.2 Cross-Platform Client on Linux 


E /opt/novell/groupwise/client GroupWise Cross-Platform client installation directory 


J gwclient.desktop Desktop shortcut for the Cross-Platform client 
J gwclient.png Desktop icon for the Cross-Platform client shortcut 
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bin 

LJ groupwise 
E lib 

O gwenlxxx. fil 
O ngwguard. dc 
O wprof.dc 

Ll « «Jar 


© 80 


Z ire 


[| logs 


Subdirectory for the Cross-Platform client executable 
Cross-Platform client executable 


Subdirectory for Cross-Platform client library files 
Cross-Platform client language resource files 

Data dictionary for local databases on the user’s workstation 
Data dictionary for the local copy of the Address Book 

Java archive (.jar) files used by the Cross-Platform client 
Shared library files used by the Cross-Platform client 


Java Runtime Environment (JRE) used by the Cross- 
Platform client 


Log files generated by the Cross-Platform client 


10.2.1 /opt/novell/groupwise/client directory 
The /opt/novell/groupwise/client directory is the default location for the Group Wise 


Cross-Platform software. The Installation program does not provide the opportunity to specify a 
different location and typically there is no need to move the software. 


gwclient.desktop file 


The gwclient .desktop file create the GroupWise Cross-Platform client shortcut on your Linux 
desktop. 


gwclient.png file 


The gwclient.png file is the GroupWise icon used for Cross-Platform client shortcut. 
10.2.2 bin directory 
The bin directory is the standard Linux location for executable files. 


groupwise file 


The groupwise file is the GroupWise Cross-Platform client executable. See “Installing the 
Group Wise Cross-Platform Client” in the GroupWise 7 Cross-Platform Client User Guide. 


10.2.3 lib directory 
The 1ib directory is the standard Linux location for library files. 


gwenlxxx.fil file 


The gwen1xxx.file provides the language-specific strings for the localized versions of the Cross- 
Platform client. The xx is a two-letter language code. 


ngwguard.dc file 


The ngwguard.dc file is the data dictionary for building the databases used by the Cross-Platform 
client. It is parallel in function to the ngwguard. dc file in the post office. 
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wprof.dc file 


The wprof .dc file is the data dictionary used to create the local copy of the Address Book that 
resides on the user’s workstation (wprof . db). 


* jar files 


The * . jar files efficiently store information referenced by the Cross-Platform client. The 
gwclient. Jar file contains the Cross-Platform online help information. 


* so files 


The * . so files are Linux shared library files the provide information to the Cross-Platform client 


executable. 


10.2.4 jre directory 


The j re directory holds the version of the Java Runtime Environment (JRE) that is required by the 


Cross-Platform client. 


10.2.5 logs directory 


The Logs directory stores log files generated by the Cross-Platform client when an error occurs. 


10.3 Cross-Platform Client on Macintosh 


El /Applications/GroupWise.app 


w Contents 
J PkgInfo 
Tuto. pList 


Bl macos 


3 Resources 
LJ GroupWise.icns 
iin 
J gwenlxxx.fil 
LJ ngwguard.dc 
wprof.dc 


GroupWise Cross-Platform client installation directory 


Standard Macintosh directory for application files 
Standard Macintosh package info file 
Standard Macintosh package list file 


Standard Macintosh directory for operating system files 


Standard Macintosh directory for resource files 
Icons used by the Cross-Platform client 


Subdirectory for Cross-Platform client library files 

Data dictionary for local databases on the user’s workstation 
Data dictionary for the local copy of the Address Book 
Cross-Platform client language information files 


JRE used by the Cross-Platform client 
Java archive (.jar) files used by the Cross-Platform client 
Dynamic libraries used by the Cross-Platform client 


10.3.1 /Applications/GroupWise.app directory 


The /Applications/GroupWise. app directory contains the GroupWise Cross-Platform 


client on Macintosh. 
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10.3.2 Contents directory 


The Contents directory is the standard location on Macintosh for all files that make up an 
application. 


10.3.3 MacOS directory 


The MacOS directory contains the JavaApplicationStub file that enables the Cross-Platform 
client to invoke the Java Virtual Machine (JVM) on Macintosh. 


10.3.4 Resources directory 


The Resources directory is the standard location on Macintosh for files that support an 
application. 


GroupWise.icns file 


The GroupWise.icns file contains all the images that display in the Cross-Platform client. 


10.3.5 lib directory 


The lib directory holds library files that provide information required by the Cross-Platform client. 


gwenlxxx.fil file 


The gwen1xxx.file provides the language-specific strings for the localized versions of the Cross- 
Platform client. The xx is a two-letter language code. 


ngwguard.dc file 


The ngwguard. dc file is the data dictionary for building the databases used by the Cross-Platform 
client. It is parallel in function to the ngwguard. dc file in the post office. 


wprof.dc file 


The wprof .dc file is the data dictionary used to create the local copy of the Address Book that 
resides on the user’s workstation (wprof . db). 


10.3.6 Java directory 


The Java directory holds the version of the Java Runtime Environment (JRE) that is required by 
the Cross-Platform client. 


* jar files 


The * . jar files efficiently store information referenced by the Cross-Platform client. The 
gwclient.jar file contains the Cross-Platform online help information. 
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* dylib files 


The * .dylib files are dynamic library files the provide information to the Cross-Platform client 
program. 
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Documentation Updates 


This section lists updates to Troubleshooting 3: Message Flow and Directory Structure that have 
been made since the initial release of GroupWise® 7. The information helps you to keep current on 
documentation updates and, in some cases, software updates (such as a Support Pack release). 


The information is grouped according to the date when Troubleshooting 3: Message Flow and 
Directory Structure was republished. Within each dated section, the updates are listed by the names 
of the main table of contents sections. 


Troubleshooting 3: Message Flow and Directory Structure has been updated on the following dates: 


+ Appendix A, “September 29, 2006,” on page 183 
+ Appendix B, “June 15, 2006 (GroupWise 7 SP1),” on page 185 
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September 29, 2006 


Location Change 


Directory Structure 


Diagrams 

Section 7.1, “Domain Added the mslocal directory in its default location under the domain 
Directory,” on page 63 directory. 

Section 8.1, “GroupWise Indicated that the DBCopy utility is now installed on NetWare® and 


Agent Installation (POA and Windows along with the agents. 
MTA),” on page 103 
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June 15, 2006 (GroupWise 7 SP1) 


Location 


Directory Structure 
Diagrams 


Section 8.4, “Monitor Agent 
Installation,” on page 133 


Section 9.1, “NetWare/ 
Windows Software 
Distribution Directory,” on 
page 147 


Entire Guide 


Change 


Added the default directory for Monitor Agent accounting files 


Added the new uw1 subdirectory for Windows client user word lists. 


Page design reformatted to comply with revised Novell documentation 


standards. 


June 15, 2006 (GroupWise 7 SP1) 
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